Add system-detailed-design.md (2033 lines, 23 sections) derived from frozen baselines and overview. Complete four-model cross-review: - DeepSeek: baseline coverage audit (PASS, 9.6/10) - MIMO 2.5 Pro: internal consistency (PASS, 9.4/10) - GPT-5.5 Pro: baseline conflict detection (Requires repair) - Opus 4.8: validation + root cause analysis (CONDITIONAL PASS, 9.1/10) Key findings requiring resolution before freeze: - P1-01: Worker exit code semantic conflict (baselineV1 vs overview) - P1-02: PromptLayerLevel enum vs L0-L9 layer name mismatch - P1-03: EventStore.project() error handling undefined - P1-04: PromptLayerLoader interface incomplete for 10 layers Coverage verified: 100% contracts, events, DB schema, state machines. Architecture validated: no circular dependencies, proper separation. Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
4.5 KiB
Executable File
4.5 KiB
Executable File
AGENTS.md
Workflow Root
- This project uses
AirPlan/as the workflow root. - Keep planning, execution state, ADR, C4, validation, debug, and plugin runtime data under
AirPlan/. - The repo-root
AGENTS.mdonly bootstraps into this file.
AirArc Workflow
- Use
AirPlan/AGENTS.mdas the canonical project context entry point. - Load and maintain:
AirPlan/docs/analysis/requirements.mdAirPlan/docs/architecture/solution-architecture.mdAirPlan/docs/architecture/system-overview-design.mdAirPlan/docs/architecture/gpt5概要设计审查.mdAirPlan/docs/architecture/mimo2.5概要设计审查.mdAirPlan/docs/architecture/Opus4.7概要设计审查.mdAirPlan/docs/architecture/DeepSeek概要设计审查.mdAirPlan/docs/architecture/概要设计修复回归审查.mdAirPlan/docs/architecture/概要设计修复回归审查-R2.mdAirPlan/docs/architecture/概要设计修复回归审查-R3.mdAirPlan/docs/architecture/system-detailed-design.mdAirPlan/docs/architecture/detailed-design-audit.mdAirPlan/docs/architecture/DeepSeek系统详细设计审查.mdAirPlan/docs/architecture/Mimo2.5pro系统详细设计审查.mdAirPlan/docs/architecture/gpt5.5pro系统详细设计审查.mdAirPlan/docs/architecture/opus4.8系统详细设计审查.mdAirPlan/docs/architecture/多模型系统详细设计交叉审查汇总.mdAirPlan/docs/architecture/baselineV1.mdAirPlan/docs/architecture/db-schema-v1.mdAirPlan/docs/architecture/event-registry-v1.mdAirPlan/docs/architecture/tool-registry-v1.mdAirPlan/docs/architecture/scheduler-state-machine-v1.mdAirPlan/docs/architecture/prompt-layering-v1.mdAirPlan/docs/architecture/provider-capability-matrix-v1.mdAirPlan/docs/architecture/error-taxonomy-v1.mdAirPlan/docs/architecture/artifact-naming-v1.mdAirPlan/docs/architecture/scope-escalation-v1.mdAirPlan/docs/architecture/security-model-v1.mdAirPlan/docs/architecture/capability-trust-v1.mdAirPlan/docs/architecture/cross-platform-matrix-v1.mdAirPlan/docs/architecture/branch-deepcode-cli/AirPlan/docs/architecture/c4/module.mdAirPlan/docs/architecture/c4/code-view.mdAirPlan/docs/architecture/interface-contracts-v1.mdAirPlan/docs/architecture/runtime-semantics-v1.mdAirPlan/docs/architecture/多模型三视角审查联合评估.mdAirPlan/docs/architecture/adr/AirPlan/docs/architecture/decisions-round-1.mdAirPlan/docs/architecture/decisions-round-2.mdAirPlan/docs/architecture/decisions-round-3.mdAirPlan/docs/architecture/main-agent-state-machine.md
- Produce or refine
AirPlan/plan.mdandAirPlan/todo.md. - Keep plans optimized for lower-cost follow-up sessions, including scope, validation, file targets, and parallelization boundaries.
- AirArc is architecture-only: it may plan tasks and edit planning or architecture documents, but it must not write code or implement tasks directly.
AirEng Workflow
- Use
/airengas the sole scheduler for confirmed execution. - Prefer
AirPlan/state/airarc/reviews/execution-plan.json, thenAirPlan/state/airarc/reviews/parallel-review.json, before falling back to localAirPlan/todo.md. - Dispatch isolated
/airdosubagents with bounded concurrency instead of defaulting to parent-thread coding. - Monitor active workers on a 5-minute cadence, merge ready results, and continue later waves automatically when work remains.
- Keep
AirPlan/todo.md,AirPlan/plan.md,AirPlan/AGENTS.md, ADR, and C4 docs synchronized during dispatch, monitoring, repair, and merge. - AirEng owns global debug, XDB, repair, intervention, and document convergence, but it should only intervene directly for hard blockers and must return to scheduler mode immediately afterward.
AirDo Workflow
- Use
/airdofor one narrow task slice fromAirPlan/todo.md. - Before editing, load:
AirPlan/AGENTS.mdAirPlan/docs/architecture/adr/AirPlan/docs/architecture/c4/module.mdAirPlan/plan.mdAirPlan/todo.md
- Keep task-local progress resumable in
AirPlan/state/airdo/. - When AirEng owns orchestration, return shared document changes through
documentUpdates. - Route GUI work through AirXDB, debugging through AirDbg, network evidence through AirNDB, and static analysis through AirSDB when needed.