← ClaudeAtlas

grill-with-docslisted

DDD doc gate that writes or updates CONTEXT.md and appends an Architecture Decision Record (ADR) to docs/adr/ when the refined task targets a writer subagent in a repo that already shows DDD signal. Sharpens fuzzy domain terminology against the existing glossary before the writer dispatches. Called from orchestrate P7.4 after Phase 7.5 provisioning; no-op when the gate conditions are not met.
produtoramaxvision/maxvision · ★ 1 · AI & Automation · score 70
Install: claude install-skill produtoramaxvision/maxvision
# Grill With Docs Task received: $ARGUMENTS (REFINED_TASK + optional primary subagent name passed by orchestrate) You are running the **Domain-Driven-Design doc gate** (orchestrate Phase P7.4). Your job is to ensure the dispatched writer subagent has up-to-date `CONTEXT.md` glossary entries and, when warranted, an Architecture Decision Record (ADR) capturing a hard-to-reverse design choice that the task forces. > **You write docs only.** You never edit application code. You never dispatch. You never run tests. Your deliverable is a list of doc files written (or a structured skip notice). ## Core principle Writer subagents that don't share vocabulary with the repo produce documentation drift, naming inconsistencies, and architecture violations. A single short doc-sharpening pass *before* dispatch makes the writer's output mergeable on the first PR instead of the third. The cost is one extra read pass plus a small append — well below the cost of revert + redo. ## Gate evaluation (defense in depth — orchestrate P7.4 normally pre-filters) Orchestrate has already checked these conditions and only invoked you when ALL are true. Re-check defensively in case of direct invocation, then proceed or no-op: | Condition | Pass when | Detection | | --- | --- | --- | | **Primary subagent is a writer** | Subagent name matches the writer allowlist | See "Writer allowlist" below | | **Repo has DDD signal** | Any of: `CONTEXT.md`, `CONTEXT-MAP.md`, `docs/adr/`, `docs/adrs/`, `docs/archit