This is a personal orchestrator repository. It owns planning, tracking, and tooling — not production code. All project code lives in git submodules under src/.
orchestrator (main)
├── ARCHITECTURE.md ← this file; living map of current system state
├── TASKS.md ← forward-looking backlog
├── CONTEXT.md ← domain relationships and examples
├── CONTEXT-MAP.md ← bounded context index (multi-context repo)
├── GLOSSARY.md ← canonical term definitions
├── LANGUAGE.md ← rejected framings and behavioral rules
├── docs/
│ ├── adr/ ← orchestrator-level architectural decisions (immutable)
│ └── tasks/ ← daily work logs (YYYY-MM-DD.md)
└── src/
└── <repo>/ ← one git submodule per project
| Concern | Location |
|---|---|
| Forward planning | TASKS.md |
| Daily work tracking | docs/tasks/YYYY-MM-DD.md |
| Architectural decisions | docs/adr/ |
| Domain language | GLOSSARY.md, LANGUAGE.md |
| Submodule tracking | src/<repo>/ pointer commits |
| AI agent governance | HITL classification (see ADR 0004) |
Replace this table with your actual projects:
| Path | Remote | Branch strategy |
|---|---|---|
src/<your-project>/ |
GitHub / Azure / etc. | See ADR 0005 if sub-submodules exist |
Innermost-first — commit and push from deepest submodule outward:
- Sub-submodule (if any) → push contributor branch, open PR into
main - After PR merges: project submodule → update sub-submodule pointer, push
main - Orchestrator → update project pointer, push
main
Reversing the order creates redundant pointer-update commits (see ADR 0001).
External tracker (source of truth) → TASKS.md (backlog) → Daily Log → commit
Work items enter TASKS.md when planned, move to the day's Daily Log when started, and close on lead-developer sign-off — not on commit (see ADR 0003).
| ADR | Decision |
|---|---|
| 0001 | Trunk-based workflow; submodules as isolation layer |
| 0002 | tag: Description commit format |
| 0003 | Planning centralised in orchestrator root |
| 0004 | HOOTL/HITLFE/HIC classification |
| 0005 | Feature branch → PR into main for sub-submodules |
| 0006 | Docker stack + reverse proxy for local dev |