* docs: clarify one-orchestrator-per-project model (closes#2005)
The architecture design doc defined "Orchestrator" only as "the central
server that manages everything," conflating the central daemon with the
per-project orchestrator agent. This implied a single orchestrator agent
spanning all projects.
The actual (and intended) model: one central daemon (`ao start`) manages
all registered projects, but each project gets its own orchestrator agent
session — one per project, enforced by the canonical orchestrator in
session-manager (ensureOrchestrator). Disambiguate the term in the
nomenclature table and the server-centric design principle.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
* docs: remove stale design/architecture artifacts (closes#2005)
Delete historical design research, implementation specs, and PR-handoff
notes that are superseded by the shipped code and the living docs
(DESIGN.md, CLAUDE.md, docs/ARCHITECTURE.md, docs/DEVELOPMENT.md). None
were linked from any current doc.
Removed:
- artifacts/ — original design research (incl. architecture-design.md,
the doc #2005 flagged for the misleading "one central orchestrator"
framing; removing it resolves the ambiguity at the source)
- docs/design/ — Feb 2026 dashboard design-research artifacts
- docs/specs/ + design-*.html — implemented feature specs/analyses
- docs/state-machine-stage2-evidence-recovery-plan.md — shipped plan
- docs/SECURITY-AUDIT-SUMMARY.md — point-in-time audit snapshot
- handoff/pr-1466/ — handoff notes for a long-merged PR
Drop the now-dangling artifacts/ entry from .cursor/BUGBOT.md ignore list.
Confirms the one-orchestrator-per-project model: code enforces a single
canonical orchestrator per project (ensureOrchestrator); no multiple
orchestrators within one project.
* docs: restore docs flagged as still-relevant by review (#2005)
@yyovil flagged several docs as still needed. Restore the full
artifacts/ and docs/design/ trees, docs/specs/project-based-dashboard-
architecture.md, and handoff/pr-1466/ (kept whole for link cohesion).
artifacts/architecture-design.md is kept WITH the one-orchestrator-per-
project clarification (the #2005 fix) rather than deleted — resolving the
ambiguity in place. Restores the artifacts/ entry in .cursor/BUGBOT.md.
Remaining removals are limited to clearly point-in-time/superseded docs:
docs/state-machine-stage2-evidence-recovery-plan.md,
docs/SECURITY-AUDIT-SUMMARY.md, and four design/spec HTML analyses.
5d0b624fbe