admin/AirCoding
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases 1 Wiki Activity

Detailed design §23: correct reference checkout paths

Browse Source 
The reference map cited bare/relative paths that did not match reality:
reference checkouts live at <repo-root>/reference/<name>-<version>/ where
repo-root is the git root (AirCoding/, parent of AirPlan/), and the tree is
working-copy only (not committed).

- Added a "Reference source location" note defining the path convention and
  requiring implementers to verify a checkout exists/non-empty before relying
  on it (clone upstream if absent).
- Versioned the Hermes / asciinema / atuin / claude-hud paths.

Documentation only.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
AirCoding
2026-06-01 15:47:02 +08:00
parent 0cbf7141c0
commit e9305a45a7
1 changed files with 8 additions and 2 deletions
Download Patch File Download Diff File Expand all files Collapse all files

10
AirPlan/docs/architecture/system-detailed-design.md
View File

@@ -2369,6 +2369,12 @@ invariants.
- `npm-dep` — consume directly as a dependency; do not re-implement.
- `fork/adapt` — copy and adapt source into our package; keep our own boundaries.
- `pattern` — reference structure/patterns; implement independently.
**Reference source location:** local reference checkouts live at `<repo-root>/reference/<name>-<version>/`
where `<repo-root>` is the git root (`AirCoding/`, the parent of `AirPlan/`). This `reference/`
tree is **not committed** (working-copy only). Implementers (including isolated subagents) must
verify the referenced checkout exists and is non-empty before relying on it; if absent, clone the
upstream repo to that path. Paths in the table below are relative to `<repo-root>`.
- `behavioral` — match observable behavior/quality; no code lineage.
| DD component | Reference project (baselineV1 §2) | Reuse mode | Notes / local path |
@@ -2378,9 +2384,9 @@ invariants.
| §12 Provider (`ProviderManager`, `ProviderAdapter`, converters) | `@opencode-ai/llm` | `fork/adapt` | D-002 list: provider/model abstraction may be forked/adapted; output stays Anthropic-canonical (D-046). |
| §8.4 + §9.4 Execution discipline (read-before-edit, exact edit, verify-before-complete) | Claude Code CLI | `behavioral` | baselineV1 §2: quality benchmark only — edit safety, patch granularity, conflict handling, verification discipline. No code lineage. |
| §9.4 `fs.edit`/`fs.patch` + §15 patch/test execution loop | OpenAI Codex (`reference/openai-codex/`) | `pattern` | baselineV1 §2: shell/patch/test direct-execution loop, tool orchestration, wider tool surface. |
| §11.3 + §14 Knowledge / ExperienceMiner / Curator | Hermes Agent | `pattern` | D-024: Nudge Engine interval trigger (~10 turns/tool-calls), Curator dedup daemon, skill self-patch. |
| §11.3 + §14 Knowledge / ExperienceMiner / Curator | Hermes Agent (`reference/hermes-agent-<version>/`) | `pattern` | D-024: Nudge Engine interval trigger (~10 turns/tool-calls), Curator dedup daemon, skill self-patch. |
| §11.3 + runtime-semantics §11 Skills (`SKILL.md`, `scripts/`/`references/`/`assets/`) | Anthropic Claude Skills (`reference/anthropic-skills/`) | `pattern` | D-058: SKILL.md frontmatter + directory layout + trigger/retrieval descriptions; SkillGenerator output format. |
| §16.2 Logging / HUD + future PTY capture | asciinema / Atuin / claude-hud | `pattern` | baselineV1 §2: PTY capture, command metadata/history indexing, HUD/statusline layout. |
| §16.2 Logging / HUD + future PTY capture | asciinema / Atuin / claude-hud (`reference/asciinema-<v>/`, `reference/atuin-<v>/`, `reference/claude-hud-<v>/`) | `pattern` | baselineV1 §2: PTY capture, command metadata/history indexing, HUD/statusline layout. |
| §3 Message format (Anthropic canonical content blocks) | Claude Code message model | `behavioral` | D-016: Text/Thinking/ToolUse/ToolResult blocks; canonical internal format. |
**Rules for reference reuse:**