A2C documentation
This section publishes documentation for the A2C (Architecture-to-Commit) product family — architecture-first, spec-driven, AI-assisted development with small reviewable commits.
A2C spans multiple repositories. This portal is the single public entry point; each repository remains the source of truth for its own docs. Sync mirrors content here at build time (see Composite sections).
Ecosystem map
| Area | Source repository | Portal path |
|---|---|---|
| Overview | Portal framing | /a2c/intro/ (this page) |
| Core / Workflow | a2c-workflow | /a2c/workflow/…, /a2c/architecture/…, /a2c/adr/… |
| Pre-commit hooks | a2c-pre-commit-hooks | /a2c/pre-commit-hooks/… |
| VS Code extension | a2c-vscode-extension | /a2c/vscode-extension/… |
Use the sidebar categories to navigate. Edit links on each page point to the owning repository.
Local sync
From a docs-portal checkout with sibling clones:
pip install -r requirements-sync.txt
python scripts/sync_workflow.py a2c --source ../a2c-workflow
python scripts/sync_workflow.py a2c-pre-commit-hooks --source ../a2c-pre-commit-hooks
python scripts/sync_workflow.py a2c-vscode-extension --source ../a2c-vscode-extension
# or sync every active contributor:
python scripts/sync_all_workflows.py
On develop, each upstream repository triggers an automated downstream sync when its docs/ change.
Editing guidance
| Change type | Where to edit |
|---|---|
| Core workflow policy, ADRs, templates | a2c-workflow/docs/ → sync |
| Hook package usage and development | a2c-pre-commit-hooks/docs/ → sync |
| Extension architecture and UI docs | a2c-vscode-extension/docs/ → sync |
| Section intro, portal navigation | This file and portal config |
| Site-wide portal documentation | docs-common/ in docs-portal |
Do not copy sibling-project documentation into a2c-workflow as the primary editing location.
Reading order
- Workflow overview and principles
- Architecture overview and repository anatomy
- Pre-commit hooks usage when adopting hooks in a project
- VS Code extension architecture when using the IDE client