Skip to content

docs: 凍結注記・ファイル目録現況化・live-e2e 対訳と索引(Bolt 4 freeze-and-parity — 260805-docs-impl-sync) #2314

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
j5ik2o merged 4 commits into from
Aug 5, 2026
Merged

docs: 凍結注記・ファイル目録現況化・live-e2e 対訳と索引(Bolt 4 freeze-and-parity — 260805-docs-impl-sync) #2314

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
4f73ccb
docs: mark the upstream sync report as a frozen snapshot
j5ik2o Aug 5, 2026
1506ca7
docs: refresh the generated file inventory against the current tree
j5ik2o Aug 5, 2026
18cf4bf
docs: add the Japanese live harness end-to-end runbook
j5ik2o Aug 5, 2026
eec4f57
docs: index the file inventory and live e2e runbook from the docs map
j5ik2o Aug 5, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 2 additions & 0 deletions docs/README.ja.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -25,6 +25,7 @@ Harness Engineer Guide と Developer Reference の境界は **データ対コー
## ビルドと貢献

メンテナは `packages/framework/core/` で著述し、`bun run dist`(`bun scripts/package.ts`)で `dist/<harness>/` ツリーを再生成します — 完全なビルド&テストのループについては [Contributing Guide](reference/11-contributing.ja.md) を、ハーネスの追加については [Porting to a New Harness](harness-engineering/09-porting-to-a-new-harness.ja.md) を参照してください。
ハーネス配布物への変更を出荷する前には、[実ハーネスのエンドツーエンド検証](harness-engineering/live-e2e.ja.md) のopt-inなローカルジャーニーを実行してください。

## 本家 AI-DLC v2の違い

Expand All @@ -37,6 +38,7 @@ Harness Engineer Guide と Developer Reference の境界は **データ対コー
- [新規プロトコルへ形式モデルを供給する](reference/22-formal-model-supply.ja.md)
- [Telemetry Schema reference](reference/23-telemetry-schema.ja.md)
- [Intent autonomy・レビュー・完了](reference/24-intent-autonomy.ja.md)
- [AI-DLC v2 生成ファイル完全目録](amadeus-files.ja.md)

リポジトリレイアウトの設計判断は
[Workspace Layout Decision](reference/18-workspace-layout.ja.md) に記録しています。
Expand Down
2 changes: 2 additions & 0 deletions docs/README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -40,6 +40,7 @@ Maintainers author in `packages/framework/core/` and `packages/framework/harness
`bun run dist` (`bun scripts/package.ts`) — see the [Contributing Guide](reference/11-contributing.md)
for the full build-and-test loop, and [Porting to a New Harness](harness-engineering/09-porting-to-a-new-harness.md)
to add one.
Before shipping a change to a harness distribution, run the opt-in local journeys in [Live Harness End-to-End Verification](harness-engineering/live-e2e.md).

## Upstream AI-DLC v2 differences

Expand All @@ -52,6 +53,7 @@ to add one.
- [Supplying a formal model for a new protocol](reference/22-formal-model-supply.md)
- [Telemetry Schema reference](reference/23-telemetry-schema.md)
- [Intent autonomy, review, and completion](reference/24-intent-autonomy.md)
- [Complete AI-DLC v2 Generated File Inventory](amadeus-files.md)

The repository layout decision is recorded in
[Workspace Layout Decision](reference/18-workspace-layout.md): the framework
Expand Down
35 changes: 28 additions & 7 deletions docs/amadeus-files.ja.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -2,17 +2,20 @@

> 言語: [English](amadeus-files.md) | **日本語**

出典(一次情報): `amadeus-dlc/amadeus` v2ブランチ(commit 9b77786, 2026-07時点)
出典(一次情報): `amadeus-dlc/amadeus`(commit f4d99c2c9, 2026-08時点)
- 公式リファレンス: `docs/guide/14-artifacts-reference.md`(ディレクトリツリー・git方針)
- ワークスペース構造: `docs/guide/03-spaces-and-intents.md`
- 正確なファイル名: `packages/framework/core/amadeus-common/stages/*/*.md` 全32ステージのfrontmatter `outputs:` から抽出
- 生成ツリー: `bun run dist` の出力(`dist/claude/.claude`、`dist/codex/.codex`、`dist/codex/.agents`)を実測
- 正確なファイル名: `packages/framework/core/amadeus-common/stages/*/*.md` 全32ステージのfrontmatter `produces:` から抽出

---

## 1. ワークスペースレベル(intent横断・スペース単位)

```
.agents/ # Codexが読むskill配布先(.codex/の兄弟)
├── rules/ # Codex向けAI-DLCルールの入口
│ └── amadeus.md
└── skills/
├── amadeus/ # オーケストレーターskill
└── amadeus-<stage-or-scope>/ # stage runner / scope runner skill
Expand All @@ -29,8 +32,10 @@
│ ├── inception/
│ ├── construction/
│ └── operation/
├── hooks/ # Claude Code hook本体(フレームワークのフック)
├── hooks/ # Claude Code hook本体(フレームワークのフック + Claude用ディスパッチャ)
│ ├── amadeus-audit-logger.ts
│ ├── amadeus-dispatch.ts
│ ├── amadeus-log-subagent-start.ts
│ ├── amadeus-log-subagent.ts
│ ├── amadeus-mint-presence.ts
│ ├── amadeus-plugin-compose.ts
Expand All @@ -45,28 +50,35 @@
├── knowledge/ # フレームワーク方法論知識(共有 + agent別)
│ ├── amadeus-shared/
│ └── amadeus-<role>-agent/
├── otel/ # OpenTelemetryプロバイダ層(全ハーネスへ配布)
├── rules/ # Claude Code側のAI-DLCルール入口
│ └── amadeus.md
├── scopes/ # scope定義(amadeus-mvp等)
│ └── amadeus-<scope>.md
├── sensors/ # 決定論センサー定義
│ ├── amadeus-answer-evidence.md
│ ├── amadeus-event-registry-drift.md
│ ├── amadeus-linter.md
│ ├── amadeus-model-completeness.md
│ ├── amadeus-required-sections.md
│ ├── amadeus-self-scope-consistency.md
│ ├── amadeus-type-check.md
│ └── amadeus-upstream-coverage.md
├── skills/ # Claude Code skill(オーケストレーター + stage runner)
│ ├── amadeus/
│ └── amadeus-<stage-or-scope>/
├── tools/ # Bunで実行する決定論エンジン/CLI(26本 + data/)
├── tools/ # Bunで実行する決定論エンジン/CLI(amadeus-*.ts + data/)
│ ├── amadeus-*.ts
│ └── data/
│ ├── harness.json
│ ├── stage-graph.json
│ ├── stage-identities.json
│ ├── scope-grid.json
│ ├── self-install-allowlist.ts
│ ├── memory-seed/
│ ├── scaffold/
│ └── templates/
├── vendor/ # ベンダリングしたOpenTelemetry API(全ハーネスへ配布)
├── CLAUDE.md # Claude Code向け導入指示
├── CLAUDE.md.example
├── settings.json # hook/statusline/permission設定
Expand All @@ -83,7 +95,9 @@
│ └── stages/
├── hooks/ # Codex hook本体(Claude共通のフレームワークフック + Codex adapter)
│ ├── amadeus-codex-adapter.ts
│ ├── amadeus-codex-hook-runtime.ts
│ ├── amadeus-audit-logger.ts
│ ├── amadeus-log-subagent-start.ts
│ ├── amadeus-log-subagent.ts
│ ├── amadeus-mint-presence.ts
│ ├── amadeus-plugin-compose.ts
Expand All @@ -98,25 +112,32 @@
├── knowledge/ # フレームワーク方法論知識(共有 + agent別)
│ ├── amadeus-shared/
│ └── amadeus-<role>-agent/
├── otel/ # OpenTelemetryプロバイダ層(全ハーネスへ配布)
├── rules/ # Codex permission rules。AI-DLC memory層とは別物
│ └── default.rules
├── scopes/ # scope定義(amadeus-mvp等)
│ └── amadeus-<scope>.md
├── sensors/ # 決定論センサー定義
│ ├── amadeus-answer-evidence.md
│ ├── amadeus-event-registry-drift.md
│ ├── amadeus-linter.md
│ ├── amadeus-model-completeness.md
│ ├── amadeus-required-sections.md
│ ├── amadeus-self-scope-consistency.md
│ ├── amadeus-type-check.md
│ └── amadeus-upstream-coverage.md
├── tools/ # Bunで実行する決定論エンジン/CLI(26本 + data/)
├── tools/ # Bunで実行する決定論エンジン/CLI(amadeus-*.ts + data/)
│ ├── amadeus-*.ts
│ └── data/
│ ├── harness.json
│ ├── stage-graph.json
│ ├── stage-identities.json
│ ├── scope-grid.json
│ ├── self-install-allowlist.ts
│ ├── memory-seed/
│ ├── scaffold/
│ └── templates/
├── vendor/ # ベンダリングしたOpenTelemetry API(全ハーネスへ配布)
├── config.toml # Codexプロジェクト設定(必要時のみ)
├── config.toml.example
├── hooks.json # Codex hookのactive file(per-clone、可変、gitignore)
Expand Down Expand Up @@ -247,7 +268,7 @@ amadeus/
| 3.3 nfr-design | `performance-design.md`, `security-design.md`, `scalability-design.md`, `reliability-design.md`, `logical-components.md` | 計画次第・per unit |
| 3.4 infrastructure-design | `deployment-architecture.md`, `infrastructure-services.md`, `monitoring-design.md`, `cicd-pipeline.md`, (条件付き) `shared-infrastructure.md` | 計画次第・per unit |
| 3.5 code-generation | `code-generation-plan.md`(チェックボックス+story追跡), `code-summary.md`(コード本体はrecord dirではなくコードリポジトリへ) | 常時・per unit |
| 3.6 build-and-test | `build-instructions.md`, `unit-test-instructions.md`, `integration-test-instructions.md`, `performance-test-instructions.md`, `security-test-instructions.md`, `build-and-test-summary.md`, `test-results.md` | 常時・全Unit後 |
| 3.6 build-and-test | `build-instructions.md`, `unit-test-instructions.md`, `integration-test-instructions.md`, `performance-test-instructions.md`, `security-test-instructions.md`, `build-and-test-summary.md`, `build-test-results.md` | 常時・全Unit後 |
| 3.7 ci-pipeline | `ci-config.md`, `quality-gates.md` | 条件付き・全Unit後 |

### 2.6 Operation(4.1–4.7、すべて条件付き)
Expand All @@ -259,7 +280,7 @@ amadeus/
| 4.3 deployment-execution | `deployment-log.md`, `smoke-test-results.md`, `health-check-report.md` |
| 4.4 observability-setup | `dashboards.md`, `alarms.md`, `slo-config.md`, `log-queries.md`, `tracing-config.md`, `anomaly-config.md` |
| 4.5 incident-response | `runbooks.md`, `incident-plan.md`, `escalation-matrix.md` |
| 4.6 performance-validation | `load-test-plan.md`, `test-results.md`, `nfr-validation-matrix.md` |
| 4.6 performance-validation | `load-test-plan.md`, `load-test-results.md`, `nfr-validation-matrix.md` |
| 4.7 feedback-optimization | `slo-report.md`, `cost-analysis.md`, `drift-report.md`, `feedback-loop.md` |

---
Expand Down
35 changes: 28 additions & 7 deletions docs/amadeus-files.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -2,17 +2,20 @@

> Languages: **English** | [日本語](amadeus-files.ja.md)

Sources of truth: `amadeus-dlc/amadeus` v2 branch (commit `9b77786`, as of 2026-07)
Sources of truth: `amadeus-dlc/amadeus` (commit `f4d99c2c9`, as of 2026-08)
- Official reference: `docs/guide/14-artifacts-reference.md` (directory tree and git policy)
- Workspace layout: `docs/guide/03-spaces-and-intents.md`
- Exact file names: extracted from the `outputs:` frontmatter in all 32 stage files under `packages/framework/core/amadeus-common/stages/*/*.md`
- Generated trees: measured from `bun run dist` output (`dist/claude/.claude`, `dist/codex/.codex`, `dist/codex/.agents`)
- Exact file names: extracted from the `produces:` frontmatter in all 32 stage files under `packages/framework/core/amadeus-common/stages/*/*.md`

---

## 1. Workspace Level (Cross-Intent, Per-Space)

```
.agents/ # Skill distribution consumed by Codex (sibling of .codex/)
├── rules/ # Codex entry point for AI-DLC rules
│ └── amadeus.md
└── skills/
├── amadeus/ # Orchestrator skill
└── amadeus-<stage-or-scope>/ # Stage runner / scope runner skill
Expand All @@ -29,8 +32,10 @@ Sources of truth: `amadeus-dlc/amadeus` v2 branch (commit `9b77786`, as of 2026-
│ ├── inception/
│ ├── construction/
│ └── operation/
├── hooks/ # Claude Code hook implementations (framework hooks)
├── hooks/ # Claude Code hook implementations (framework hooks + Claude dispatcher)
│ ├── amadeus-audit-logger.ts
│ ├── amadeus-dispatch.ts
│ ├── amadeus-log-subagent-start.ts
│ ├── amadeus-log-subagent.ts
│ ├── amadeus-mint-presence.ts
│ ├── amadeus-plugin-compose.ts
Expand All @@ -45,28 +50,35 @@ Sources of truth: `amadeus-dlc/amadeus` v2 branch (commit `9b77786`, as of 2026-
├── knowledge/ # Framework methodology knowledge (shared + per-agent)
│ ├── amadeus-shared/
│ └── amadeus-<role>-agent/
├── otel/ # OpenTelemetry provider layer (ships to every harness)
├── rules/ # Claude Code entry point for AI-DLC rules
│ └── amadeus.md
├── scopes/ # Scope definitions such as amadeus-mvp
│ └── amadeus-<scope>.md
├── sensors/ # Deterministic sensor definitions
│ ├── amadeus-answer-evidence.md
│ ├── amadeus-event-registry-drift.md
│ ├── amadeus-linter.md
│ ├── amadeus-model-completeness.md
│ ├── amadeus-required-sections.md
│ ├── amadeus-self-scope-consistency.md
│ ├── amadeus-type-check.md
│ └── amadeus-upstream-coverage.md
├── skills/ # Claude Code skills (orchestrator + stage runners)
│ ├── amadeus/
│ └── amadeus-<stage-or-scope>/
├── tools/ # Deterministic Bun engine / CLI (26 files + data/)
├── tools/ # Deterministic Bun engine / CLI (amadeus-*.ts + data/)
│ ├── amadeus-*.ts
│ └── data/
│ ├── harness.json
│ ├── stage-graph.json
│ ├── stage-identities.json
│ ├── scope-grid.json
│ ├── self-install-allowlist.ts
│ ├── memory-seed/
│ ├── scaffold/
│ └── templates/
├── vendor/ # Vendored OpenTelemetry API (ships to every harness)
├── CLAUDE.md # Claude Code onboarding instructions
├── CLAUDE.md.example
├── settings.json # Hook, statusline, and permission settings
Expand All @@ -83,7 +95,9 @@ Sources of truth: `amadeus-dlc/amadeus` v2 branch (commit `9b77786`, as of 2026-
│ └── stages/
├── hooks/ # Codex hook implementations (shared framework hooks + Codex adapter)
│ ├── amadeus-codex-adapter.ts
│ ├── amadeus-codex-hook-runtime.ts
│ ├── amadeus-audit-logger.ts
│ ├── amadeus-log-subagent-start.ts
│ ├── amadeus-log-subagent.ts
│ ├── amadeus-mint-presence.ts
│ ├── amadeus-plugin-compose.ts
Expand All @@ -98,25 +112,32 @@ Sources of truth: `amadeus-dlc/amadeus` v2 branch (commit `9b77786`, as of 2026-
├── knowledge/ # Framework methodology knowledge (shared + per-agent)
│ ├── amadeus-shared/
│ └── amadeus-<role>-agent/
├── otel/ # OpenTelemetry provider layer (ships to every harness)
├── rules/ # Codex permission rules; separate from the AI-DLC memory layer
│ └── default.rules
├── scopes/ # Scope definitions such as amadeus-mvp
│ └── amadeus-<scope>.md
├── sensors/ # Deterministic sensor definitions
│ ├── amadeus-answer-evidence.md
│ ├── amadeus-event-registry-drift.md
│ ├── amadeus-linter.md
│ ├── amadeus-model-completeness.md
│ ├── amadeus-required-sections.md
│ ├── amadeus-self-scope-consistency.md
│ ├── amadeus-type-check.md
│ └── amadeus-upstream-coverage.md
├── tools/ # Deterministic Bun engine / CLI (26 files + data/)
├── tools/ # Deterministic Bun engine / CLI (amadeus-*.ts + data/)
│ ├── amadeus-*.ts
│ └── data/
│ ├── harness.json
│ ├── stage-graph.json
│ ├── stage-identities.json
│ ├── scope-grid.json
│ ├── self-install-allowlist.ts
│ ├── memory-seed/
│ ├── scaffold/
│ └── templates/
├── vendor/ # Vendored OpenTelemetry API (ships to every harness)
├── config.toml # Codex project configuration (only when needed)
├── config.toml.example
├── hooks.json # Local active Codex hooks (per-clone, mutable, gitignored)
Expand Down Expand Up @@ -247,7 +268,7 @@ Stages 3.1-3.5 repeat **per Unit of Work** and write to `construction/{unit-name
| 3.3 nfr-design | `performance-design.md`, `security-design.md`, `scalability-design.md`, `reliability-design.md`, `logical-components.md` | Plan-dependent, per unit |
| 3.4 infrastructure-design | `deployment-architecture.md`, `infrastructure-services.md`, `monitoring-design.md`, `cicd-pipeline.md`, and conditionally `shared-infrastructure.md` | Plan-dependent, per unit |
| 3.5 code-generation | `code-generation-plan.md` (checkboxes + story tracking), `code-summary.md` (actual code goes to the code repository, not the record directory) | Always, per unit |
| 3.6 build-and-test | `build-instructions.md`, `unit-test-instructions.md`, `integration-test-instructions.md`, `performance-test-instructions.md`, `security-test-instructions.md`, `build-and-test-summary.md`, `test-results.md` | Always, after all units |
| 3.6 build-and-test | `build-instructions.md`, `unit-test-instructions.md`, `integration-test-instructions.md`, `performance-test-instructions.md`, `security-test-instructions.md`, `build-and-test-summary.md`, `build-test-results.md` | Always, after all units |
| 3.7 ci-pipeline | `ci-config.md`, `quality-gates.md` | Conditional, after all units |

### 2.6 Operation (4.1-4.7, All Conditional)
Expand All @@ -259,7 +280,7 @@ Stages 3.1-3.5 repeat **per Unit of Work** and write to `construction/{unit-name
| 4.3 deployment-execution | `deployment-log.md`, `smoke-test-results.md`, `health-check-report.md` |
| 4.4 observability-setup | `dashboards.md`, `alarms.md`, `slo-config.md`, `log-queries.md`, `tracing-config.md`, `anomaly-config.md` |
| 4.5 incident-response | `runbooks.md`, `incident-plan.md`, `escalation-matrix.md` |
| 4.6 performance-validation | `load-test-plan.md`, `test-results.md`, `nfr-validation-matrix.md` |
| 4.6 performance-validation | `load-test-plan.md`, `load-test-results.md`, `nfr-validation-matrix.md` |
| 4.7 feedback-optimization | `slo-report.md`, `cost-analysis.md`, `drift-report.md`, `feedback-loop.md` |

---
Expand Down
Loading
Loading