How manatunga/quilchoom works
Quilchoom is a local-first developer tool that captures Git activity as evidence, distills it into traceable knowledge claims, and generates versioned documentation. The principal workflow runs through the CLI and application services, with a local database for project state and an AI provider for interpretation and generation. The README establishes the domain pipeline; SOURCE INDEX references support the sampled service dependencies. Some subsystems are represented at directory level because their implementation excerpts were not provided.
Main entry points: cli.py CLI commands · interpret_history.py Interpret evidence · generate_document.py Generate documents · repositories.py Local database
Components 20
CLI and workflows
- CLI commands
src/quilchoom/cli.py - Initialize project
src/quilchoom/application/initialize_project.py - Capture commits
src/quilchoom/application/capture_repository.py - Reconstruct history
src/quilchoom/application/reconstruct_history.py - Interpret evidence
src/quilchoom/application/interpret_history.py - Generate documents
src/quilchoom/application/generate_document.py - Project status
src/quilchoom/application/get_project_status.py
Knowledge lifecycle
- Development evidence
src/quilchoom/domain/evidence.py - History entries
src/quilchoom/domain/history.py - Knowledge claims
src/quilchoom/domain/knowledge_claim.py - Document versions
src/quilchoom/domain/document.py
Local infrastructure
- Git repository
src/quilchoom/infrastructure/git/repository.py - Local database
src/quilchoom/infrastructure/database/repositories.py - Local workspace
src/quilchoom/infrastructure/filesystem/workspace.py - Terminal output / export
src/quilchoom/ui/terminal.py
AI generation
- LLM interpreter
src/quilchoom/infrastructure/ai/llm_knowledge_interpreter.py - LLM document generator
src/quilchoom/infrastructure/ai/llm_document_generator.py - LLM provider adapter
src/quilchoom/infrastructure/ai/openai_provider.py
Other components
- Developer
- OpenAI service
Connections 29
- Developer → CLI commands: runs commands
- CLI commands → Initialize project: dispatches
src/quilchoom/cli.py - CLI commands → Capture commits: dispatches
src/quilchoom/cli.py - CLI commands → Reconstruct history: dispatches
src/quilchoom/cli.py - CLI commands → Interpret evidence: dispatches
src/quilchoom/cli.py - CLI commands → Generate documents: dispatches
src/quilchoom/cli.py - CLI commands → Project status: dispatches
src/quilchoom/cli.py - Initialize project → Local workspace: initializes
src/quilchoom/application/initialize_project.py - Initialize project → Local database: configures
src/quilchoom/application/initialize_project.py - Capture commits → Git repository: lists commits
src/quilchoom/application/capture_repository.py - Capture commits → Local database: checks and saves
src/quilchoom/application/capture_repository.py - Capture commits → Development evidence: records
- Development evidence → Reconstruct history: reconstructs into
- Reconstruct history → History entries: presents
- Interpret evidence → History entries: interprets
src/quilchoom/application/interpret_history.py - Interpret evidence → LLM interpreter: requests interpretation
src/quilchoom/application/interpret_history.py - LLM interpreter → LLM provider adapter: requests structured output
src/quilchoom/infrastructure/ai/llm_knowledge_interpreter.py - LLM provider adapter → OpenAI service: sends requests
- Interpret evidence → Local database: loads and saves
src/quilchoom/application/interpret_history.py - Interpret evidence → Knowledge claims: derives
src/quilchoom/application/interpret_history.py - Knowledge claims → Development evidence: trace to
- Generate documents → Knowledge claims: uses active claims
src/quilchoom/application/generate_document.py - Generate documents → LLM document generator: requests generation
src/quilchoom/application/generate_document.py - LLM document generator → LLM provider adapter: requests structured output
src/quilchoom/infrastructure/ai/llm_document_generator.py - Generate documents → Local database: loads and versions
src/quilchoom/application/generate_document.py - Generate documents → Document versions: creates versions
src/quilchoom/application/generate_document.py - CLI commands → Terminal output / export: shows and exports
src/quilchoom/cli.py - Project status → Local database: checks workflow state
src/quilchoom/application/get_project_status.py - Project status → Git repository: checks repository
src/quilchoom/application/get_project_status.py