A command that starts a DDD Architecture Coach, which guides architecture work by business area and development phase. It checks saved project files to decide what should happen next.

Use it with a business-area name to enter the next phase, or without one to see current work, completed phases, and suggested next steps.

It turns an architecture effort into a tracked sequence instead of making you guess which phase or business area to work on.

arch-coach — Command for Claude Code by jed1978

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Clone the repo

git clone --depth 1 https://github.com/jed1978/ddd-architecture-coach

Made for: Claude Code.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

README.md

[![agentmods](https://agentmods.dev/badge/commands/jed1978/ddd-architecture-coach/arch-coach/github.svg)](https://agentmods.dev/commands/jed1978/ddd-architecture-coach/arch-coach)

Your own site

<a href="https://agentmods.dev/commands/jed1978/ddd-architecture-coach/arch-coach"><img src="https://agentmods.dev/badge/commands/jed1978/ddd-architecture-coach/arch-coach/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

Your own site · 80×15

<a href="https://agentmods.dev/commands/jed1978/ddd-architecture-coach/arch-coach"><img src="https://agentmods.dev/badge/commands/jed1978/ddd-architecture-coach/arch-coach.svg" alt="Reviewed on agentmods" width="80" height="20"></a>

Per session 55 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.

When invoked 696 The whole file, excluding the scripts and references it only reads on demand.

Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.

Origin original No closer match found in the catalogue.

Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

Model	Per session	Once invoked
Fable 5.1	$0.00055	$0.00696
Opus 5	$0.00028	$0.00348
Sonnet 5	$0.00011	$0.00139
Haiku 4.5	$0.00006	$0.00070

Measured 9d ago against content hash c491bde70295, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-09, from the pricing page.

Security

Grade A, and why

arch-coach scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 9d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

assets/commands/arch-coach.md · 42 lines

What it actually says

請啟動 DDD Architecture Coach（ddd-architecture-coach skill）。

Argument handling:

`/arch-coach <BC>` — BC 已知

從 $ARGUMENTS 取得 BC 名稱
Probe {coach_output_root}/{bc}/ 決定該進入哪個 phase：
- 沒有 discovery.md → Phase 1 Steps 6–7（pre-flight：先確認 system Steps 1–5 已完成；若否 → 引導使用者跑 /phase-1）
- 有 discovery.md、沒有 decisions.md → Phase 2
- 有 decisions.md、沒有 spec.md 或 spec.md frontmatter status: draft → Phase 3
- spec.md frontmatter status: v1.x → 該 BC 已穩定；建議 /phase-4 Phase 3:<BC> 做 review
進入 phase 時更新 .claude/arch-state.md 的 last_touched: { bc, phase, at: <today> }

`/arch-coach`（無參數）— 顯示 in-flight 摘要

讀取 .claude/arch-state.md 取得 last_touched（若是舊版 current_focus schema → 靜默 migrate，見 SKILL.md → State Determination → Migration）
Probe {coach_output_root}/ 列舉 in-flight 工作：
- System-level：Steps 1–5 完成度、touchpoints.md 是否存在
- 對 {coach_output_root}/ 下每個非 system/ 子目錄：依「BC 已知」分支的邏輯推算 next phase
渲染 in-flight 摘要表給使用者：

BC 上次完成下一步備註

Channel Phase 2 Phase 3 (draft) spec.md status: draft

Operator Phase 1 Phase 2 —

(system) Steps 1–5 ✓ — touchpoints.md 缺 → 見 open_questions
詢問使用者要 focus 哪個 BC。預設建議 last_touched.bc（若該 BC 仍 in flight）；否則建議 {coach_output_root}/{bc}/ 中 file mtime 最新的 BC
使用者選定後 → 走「BC 已知」分支

BC	上次完成	下一步	備註
Channel	Phase 2	Phase 3 (draft)	spec.md status: draft
Operator	Phase 1	Phase 2	—
(system)	Steps 1–5 ✓	—	touchpoints.md 缺 → 見 open_questions

執行步驟：

若 .claude/arch-state.md 不存在或 project-context.md 未填妥 → 執行 Bootstrap 對話流程
依上面的 argument handling 邏輯決定 BC + phase
開始該 phase 的工作

$ARGUMENTS

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

9d ago First seen · 42 lines · 55 tokens per session scan A c491bde70295

Subscribe to this mod's changes

arch-coach is a command published in the GitHub repository jed1978/ddd-architecture-coach (5 stars, last pushed 4mo ago), licensed MIT. It adds 55 tokens to every session and 696 once invoked, about $0.0003 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Claude Code Planning bounded-context claude-skills ddd domain-driven-design software-architecture

tenets-scaffold

You are initializing the architecture foundation for the Flask service in the current repository. This workflow supports one service only. It does not generate individual bounded contexts, workflows, features, or resources.

bardiakhosravi/tenets · 0 tokens

tenets-review-architecture

You are a strict architecture reviewer for a codebase following Hexagonal Architecture (Ports & Adapters) with Domain-Driven Design.

bardiakhosravi/tenets · 0 tokens

review

Submit a story for verification (In Progress → In Review, no PR yet).

nunoamorim99/agile-ledger · 16 tokens

wp-cleanup

Find and clean up unused PHP code, Composer dependencies, imports, and dead code in WordPress projects.

iwritec0de/wp-dev · 20 tokens

audit

Adversarial, exhaustive review of the entire repository across code, tests, documentation, and configuration, with optional fixing in the same run. Assumes the code is incorrect until proven otherwise. This is the default command when the invocation names no other.

ivuorinen/skills · 0 tokens

a

Intercept Mode - Auto-improve and execute immediately.

joseph0926/prompt-shield · 9 tokens