Files
AirCoding/AirPlan/docs
AirCoding 0cbf7141c0 Detailed design: add §23 Reference Implementation Map
Closes the traceability gap where baselineV1 §2 / decisions-round-1..3
mandate reusing mature reference-project code, but the detailed design and
class diagrams had消化d those references into own abstractions with zero
explicit "consult X here" pointers — risking context-isolated implementers
re-deriving renderers, diff engines, or skill formats from scratch.

New §23 maps each DD component to its reference project, with an explicit
reuse mode (npm-dep / fork/adapt / pattern / behavioral) and local path:
- TUI → @opentui/* (npm-dep) + OpenCode patterns (pattern)
- Provider → @opencode-ai/llm (fork/adapt)
- Execution discipline → Claude Code (behavioral)
- patch/test loop → OpenAI Codex (pattern, reference/openai-codex/)
- Knowledge/ExperienceMiner → Hermes (pattern)
- Skills → Anthropic Claude Skills (pattern, reference/anthropic-skills/)
- Logging/HUD/PTY → asciinema/Atuin/claude-hud (pattern)
- Message format → Claude Code blocks (behavioral)

Reuse rules preserve §2 import direction and §18.6 invariants; reference
internal models never leak across our boundaries (e.g. no OpenCode session
state). Freeze declaration renumbered §23 → §24. Pure documentation; zero
change to contracts, events, schema, or runtime semantics.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-06-01 15:27:47 +08:00
..