How ai-driven-dev/framework works
AIDD is an AI coding-tool SDLC framework, with a CLI that installs and manages its tool integrations and plugins. Its wider runtime includes marketplace distribution, content translation, telemetry collection/reporting, and a Kanban task view. The principal user path is invoking CLI commands to set up or install framework content for a supported tool; the manifest and filesystem adapters provide an internal persistence layer. Several product areas are represented by directory-level nodes because their implementation was not excerpted; README-backed links document capabilities, not inspected call chains.
Main entry points: install Setup and install · post-install-pipeline-use-case.ts Post-install steps · list-task-documents.ts Task listing · cli.ts CLI entry
Components 21
CLI workflows
- CLI entry
cli/src/cli.ts - Setup and install
cli/src/contexts/framework/application/install - Install manifest
cli/src/contexts/framework/domain/manifest.ts - Manifest persistence
cli/src/contexts/framework/infrastructure/manifest-repository-adapter.ts - Post-install steps
cli/src/contexts/framework/application/install/post-install-pipeline-use-case.ts - Gitignore updates
cli/src/contexts/framework/application/gitignore-use-case.ts
Plugin distribution
- Marketplace operations
cli/src/contexts/distribution/application - Plugin catalog
cli/src/contexts/distribution/domain/catalog.ts - Catalog reader
cli/src/contexts/distribution/infrastructure/plugin-catalog-repository-adapter.ts
Tool integration
- Plugin translation
cli/src/contexts/translate/application/translate-source.ts - Tool profiles
cli/src/contexts/tools/domain/profiles
Telemetry
- Telemetry hooks
plugins/aidd-telemetry/hooks - Telemetry commands
cli/src/contexts/telemetry/application - Telemetry sink
cli/src/contexts/telemetry/infrastructure/telemetry-sink-adapter.ts
Task tracking
- Kanban views
kanban/src/presentation/commands/list-command.ts - Task listing
kanban/src/application/use-cases/list-task-documents.ts - Markdown task reader
kanban/src/infrastructure/filesystem/filesystem-task-document-repository.ts - Task grouping
kanban/src/domain/models/task-group.ts
Other components
- Engineer
- AI coding tool
- Project task files
Connections 20
- Engineer → CLI entry: runs commands
README.md - CLI entry → Setup and install: routes workflow
- Setup and install → AI coding tool: installs framework
README.md - Setup and install → Post-install steps: runs post-install
cli/src/contexts/framework/application/install/post-install-pipeline-use-case.ts - Post-install steps → Manifest persistence: saves manifest
- Post-install steps → Gitignore updates: updates ignores
cli/src/contexts/framework/application/install/post-install-pipeline-use-case.ts - Manifest persistence → Install manifest: loads and saves
cli/src/contexts/framework/infrastructure/manifest-repository-adapter.ts - Engineer → Marketplace operations: manages plugins
README.md - Marketplace operations → Catalog reader: loads catalog
- Catalog reader → Plugin catalog: parses catalog
cli/src/contexts/distribution/infrastructure/plugin-catalog-repository-adapter.ts - Engineer → Plugin translation: translates content
README.md - Plugin translation → Tool profiles: targets tools
- AI coding tool → Telemetry hooks: runs hooks
README.md - Telemetry hooks → Telemetry sink: records events
- Engineer → Telemetry commands: manages telemetry
- Engineer → Kanban views: views tasks
- Kanban views → Task listing: requests documents
kanban/src/presentation/commands/list-command.ts - Task listing → Markdown task reader: reads documents
kanban/src/application/use-cases/list-task-documents.ts - Markdown task reader → Project task files: reads Markdown
kanban/src/infrastructure/filesystem/filesystem-task-document-repository.ts - Task listing → Task grouping: groups documents
kanban/src/application/use-cases/list-task-documents.ts