cleargate 0.1.0-alpha.1 → 0.2.0

package/dist/templates/cleargate-planning/MANIFEST.json

@@ -0,0 +1,160 @@
+{
+  "cleargate_version": "0.2.0",
+  "generated_at": "2026-04-19T16:46:17.751Z",
+  "files": [
+    {
+      "path": ".claude/agents/architect.md",
+      "sha256": "0e0e545198cfff827ea453195414d884aec5cb5413e07dc1396820aaa2014f97",
+      "tier": "agent",
+      "overwrite_policy": "always",
+      "preserve_on_uninstall": false
+    },
+    {
+      "path": ".claude/agents/cleargate-wiki-ingest.md",
+      "sha256": "6dcd13bb9c8daeac083e2e2f34eebc56dbd3a9f3e6e0025bc3db558937fcff36",
+      "tier": "agent",
+      "overwrite_policy": "always",
+      "preserve_on_uninstall": false
+    },
+    {
+      "path": ".claude/agents/cleargate-wiki-lint.md",
+      "sha256": "97d930aa906e350ce7975bc0cf17cd6870aea2b636ef482b33ffc638cdba931a",
+      "tier": "agent",
+      "overwrite_policy": "always",
+      "preserve_on_uninstall": false
+    },
+    {
+      "path": ".claude/agents/cleargate-wiki-query.md",
+      "sha256": "73706e80bd1ff0ef565c38bbbe12870d49fcc78f9294cab4f55c359caa24d70c",
+      "tier": "agent",
+      "overwrite_policy": "always",
+      "preserve_on_uninstall": false
+    },
+    {
+      "path": ".claude/agents/developer.md",
+      "sha256": "bd9bcd8ce222effa248ff489939a7e37aa8e151675311fc7b374533c09ef43ee",
+      "tier": "agent",
+      "overwrite_policy": "always",
+      "preserve_on_uninstall": false
+    },
+    {
+      "path": ".claude/agents/qa.md",
+      "sha256": "9345a4f294cbc327ecc169a51446e2321b53b14917e7880f7e7b374a28ac3751",
+      "tier": "agent",
+      "overwrite_policy": "always",
+      "preserve_on_uninstall": false
+    },
+    {
+      "path": ".claude/agents/reporter.md",
+      "sha256": "a83497454969e81015e7d0415e86a3bcf48cafb13741ed7f18b603f9e54cfb80",
+      "tier": "agent",
+      "overwrite_policy": "always",
+      "preserve_on_uninstall": false
+    },
+    {
+      "path": ".claude/hooks/session-start.sh",
+      "sha256": "b851f34c8e40eb10d6dc71c8dbd29282f74afbaad7e823306a3e2a52a15fe21f",
+      "tier": "hook",
+      "overwrite_policy": "always",
+      "preserve_on_uninstall": false
+    },
+    {
+      "path": ".claude/hooks/stamp-and-gate.sh",
+      "sha256": "a9ab1afb6ef18ff954543a218b0d1a1b433dc85ca0311b34e785b17b08ced0df",
+      "tier": "hook",
+      "overwrite_policy": "always",
+      "preserve_on_uninstall": false
+    },
+    {
+      "path": ".claude/hooks/token-ledger.sh",
+      "sha256": "918ae12960f2c657c7ad1b0b7bc95438a4339d220f75e4abf5259ecabe8a2ca3",
+      "tier": "hook",
+      "overwrite_policy": "always",
+      "preserve_on_uninstall": false
+    },
+    {
+      "path": ".claude/settings.json",
+      "sha256": "1f95f5468db19ffebe75aec1c35489a26aae64eae256d246a6a88cf34581f4bb",
+      "tier": "cli-config",
+      "overwrite_policy": "merge-3way",
+      "preserve_on_uninstall": false
+    },
+    {
+      "path": ".claude/skills/flashcard/SKILL.md",
+      "sha256": "56d6bf3797516ac26ada15876ef2f4cf43842b3af7300abef502a75bd177639e",
+      "tier": "skill",
+      "overwrite_policy": "always",
+      "preserve_on_uninstall": false
+    },
+    {
+      "path": ".cleargate/FLASHCARD.md",
+      "sha256": null,
+      "tier": "user-artifact",
+      "overwrite_policy": "skip",
+      "preserve_on_uninstall": true
+    },
+    {
+      "path": ".cleargate/knowledge/cleargate-protocol.md",
+      "sha256": "fc67af361fbd11137404d3db1034ceb5f876cd8de0e4f90e208ef19ab89072a6",
+      "tier": "protocol",
+      "overwrite_policy": "merge-3way",
+      "preserve_on_uninstall": false
+    },
+    {
+      "path": ".cleargate/knowledge/readiness-gates.md",
+      "sha256": "0d5d254bb6c464c5cfa675927b5b358590cfbf8d2b1c7179519ef4780bb8da7f",
+      "tier": "protocol",
+      "overwrite_policy": "merge-3way",
+      "preserve_on_uninstall": false
+    },
+    {
+      "path": ".cleargate/templates/Bug.md",
+      "sha256": "9f32165a709b30bc8794ef96c6a7220ef6484b47c30fb955e1c1c8e892698bcc",
+      "tier": "template",
+      "overwrite_policy": "merge-3way",
+      "preserve_on_uninstall": false
+    },
+    {
+      "path": ".cleargate/templates/CR.md",
+      "sha256": "55ea7a8a25c6b3d37103065dd91eb11378a78a36375d274406d376f4c35af3ef",
+      "tier": "template",
+      "overwrite_policy": "merge-3way",
+      "preserve_on_uninstall": false
+    },
+    {
+      "path": ".cleargate/templates/epic.md",
+      "sha256": "1847f1e7cedd631d4ef2aaf7ef67745e88b2ff76389b04bad6fa1f1edf973442",
+      "tier": "template",
+      "overwrite_policy": "merge-3way",
+      "preserve_on_uninstall": false
+    },
+    {
+      "path": ".cleargate/templates/initiative.md",
+      "sha256": "9bf4a5a5ff7af0938ff48d5eaa182f227195d101ba9de4d56123b4fc211b8cac",
+      "tier": "template",
+      "overwrite_policy": "merge-3way",
+      "preserve_on_uninstall": false
+    },
+    {
+      "path": ".cleargate/templates/proposal.md",
+      "sha256": "1a0822edf6f29a1f8d34e2fab1180b33a365edd92d84b3fc191f239a751ba373",
+      "tier": "template",
+      "overwrite_policy": "merge-3way",
+      "preserve_on_uninstall": false
+    },
+    {
+      "path": ".cleargate/templates/Sprint Plan Template.md",
+      "sha256": "6e60b697a136edb89bc19cc40caa1bec51687366b8e1b35a6554d0072736591b",
+      "tier": "template",
+      "overwrite_policy": "merge-3way",
+      "preserve_on_uninstall": false
+    },
+    {
+      "path": ".cleargate/templates/story.md",
+      "sha256": "3e722c51f706177f08c16b56ef984090c7841102f70384bb47d5442846991fe8",
+      "tier": "template",
+      "overwrite_policy": "merge-3way",
+      "preserve_on_uninstall": false
+    }
+  ]
+}

package/dist/templates/synthesis/active-sprint.md

@@ -0,0 +1,30 @@
+# Active Sprint
+
+> Auto-generated by `cleargate wiki build`. Do not edit manually.
+
+## Current Sprint
+
+{{#active}}
+- [[{{id}}]] — status: {{status}}
+{{/active}}
+{{#no_active}}
+_No active sprint found._
+{{/no_active}}
+
+## Planned Sprints
+
+{{#planned}}
+- [[{{id}}]] — status: {{status}}
+{{/planned}}
+{{#no_planned}}
+_No planned sprints._
+{{/no_planned}}
+
+## Recently Completed Sprints
+
+{{#completed}}
+- [[{{id}}]] — completed: {{completed_at}}
+{{/completed}}
+{{#no_completed}}
+_No completed sprints._
+{{/no_completed}}

package/dist/templates/synthesis/open-gates.md

@@ -0,0 +1,38 @@
+# Open Gates
+
+> Auto-generated by `cleargate wiki build`. Do not edit manually.
+
+Items awaiting human action at one of the three ClearGate review gates.
+
+## Gate 1 — Pending Proposal Approval
+
+Proposals with `approved: false` or `status: Draft` that have not yet been blessed.
+
+{{#gate1}}
+- [[{{id}}]] — status: {{status}}
+{{/gate1}}
+{{#no_gate1}}
+_No items pending Gate 1 approval._
+{{/no_gate1}}
+
+## Gate 2 — Pending Story Ambiguity Clearance
+
+Stories with medium or high ambiguity that need design decisions before work can start.
+
+{{#gate2}}
+- [[{{id}}]] — ambiguity: {{ambiguity}}
+{{/gate2}}
+{{#no_gate2}}
+_No items pending Gate 2 ambiguity clearance._
+{{/no_gate2}}
+
+## Gate 3 — Ready to Push (not yet synced)
+
+Items with `status: Ready` that have not been pushed to the remote PM tool (`remote_id` is empty).
+
+{{#gate3}}
+- [[{{id}}]] — status: {{status}}
+{{/gate3}}
+{{#no_gate3}}
+_No items pending Gate 3 push._
+{{/no_gate3}}

package/dist/templates/synthesis/product-state.md

@@ -0,0 +1,32 @@
+# Product State
+
+> Auto-generated by `cleargate wiki build`. Do not edit manually.
+
+## Summary
+
+| Type | Total | Active | Shipped |
+|------|-------|--------|---------|
+| Epics | {{total_epics}} | {{active_epics}} | {{shipped_epics}} |
+| Stories | {{total_stories}} | {{active_stories}} | {{shipped_stories}} |
+| Sprints | {{total_sprints}} | {{active_sprints}} | {{shipped_sprints}} |
+| Proposals | {{total_proposals}} | {{active_proposals}} | {{shipped_proposals}} |
+| CRs | {{total_crs}} | {{active_crs}} | {{shipped_crs}} |
+| Bugs | {{total_bugs}} | {{active_bugs}} | {{shipped_bugs}} |
+
+## Active Epics
+
+{{#active_epics_list}}
+- [[{{id}}]] — status: {{status}}
+{{/active_epics_list}}
+{{#no_active_epics}}
+_No active epics._
+{{/no_active_epics}}
+
+## Shipped This Cycle
+
+{{#shipped_items}}
+- [[{{id}}]] ({{bucket}}) — {{status}}
+{{/shipped_items}}
+{{#no_shipped}}
+_Nothing shipped yet this cycle._
+{{/no_shipped}}

package/dist/templates/synthesis/roadmap.md

@@ -0,0 +1,63 @@
+# Roadmap
+
+> Auto-generated by `cleargate wiki build`. Do not edit manually.
+
+## In-Flight Sprints
+
+Sprints currently active (`activated_at` set, `completed_at` not set).
+
+{{#in_flight_sprints}}
+- [[{{id}}]] — activated: {{activated_at}}
+{{/in_flight_sprints}}
+{{#no_in_flight_sprints}}
+_No sprints currently in flight._
+{{/no_in_flight_sprints}}
+
+## Planned Sprints
+
+Sprints not yet started (`activated_at` not set).
+
+{{#planned_sprints}}
+- [[{{id}}]] — status: {{status}}
+{{/planned_sprints}}
+{{#no_planned_sprints}}
+_No planned sprints._
+{{/no_planned_sprints}}
+
+## Shipped Sprints
+
+Sprints with `completed_at` set.
+
+{{#shipped_sprints}}
+- [[{{id}}]] — completed: {{completed_at}}
+{{/shipped_sprints}}
+{{#no_shipped_sprints}}
+_No shipped sprints._
+{{/no_shipped_sprints}}
+
+## Active Epics
+
+{{#active_epics}}
+- [[{{id}}]] — status: {{status}}
+{{/active_epics}}
+{{#no_active_epics}}
+_No active epics._
+{{/no_active_epics}}
+
+## Planned Epics
+
+{{#planned_epics}}
+- [[{{id}}]] — status: {{status}}
+{{/planned_epics}}
+{{#no_planned_epics}}
+_No planned epics._
+{{/no_planned_epics}}
+
+## Shipped Epics
+
+{{#shipped_epics}}
+- [[{{id}}]] — status: {{status}}
+{{/shipped_epics}}
+{{#no_shipped_epics}}
+_No shipped epics._
+{{/no_shipped_epics}}

package/package.json

@@ -1,9 +1,9 @@
 {
   "name": "cleargate",
-  "version": "0.1.0-alpha.1",
+  "version": "0.2.0",
   "private": false,
   "type": "module",
-  "description": "ClearGate CLI — connects AI agent teams to the ClearGate MCP server",
+  "description": "Planning framework for Claude Code agents — sprint/epic/story protocol, four-agent loop (architect/developer/qa/reporter), Karpathy-style awareness wiki.",
   "bin": {
     "cleargate": "dist/cli.js"
   },
@@ -23,12 +23,14 @@
   },
   "files": [
     "dist",
+    "templates",
     "README.md"
   ],
   "engines": {
     "node": ">=24.0.0"
   },
   "scripts": {
+    "prebuild": "tsx scripts/build-manifest.ts && node scripts/copy-planning-payload.mjs",
     "build": "tsup",
     "dev": "tsup --watch",
     "typecheck": "tsc --noEmit",
@@ -39,11 +41,16 @@
   "dependencies": {
     "@napi-rs/keyring": "^1.2.0",
     "commander": "^12",
+    "diff": "^5.2.2",
+    "js-yaml": "^4.1.0",
     "zod": "^4.3.0"
   },
   "devDependencies": {
+    "@types/diff": "^5.2.3",
+    "@types/js-yaml": "^4.0.9",
     "@types/node": "^24.0.0",
     "tsup": "^8",
+    "tsx": "^4.21.0",
     "typescript": "^5.8.0",
     "vitest": "^2.1.0"
   }

package/templates/cleargate-planning/.claude/agents/architect.md

@@ -0,0 +1,57 @@
+---
+name: architect
+description: Use BEFORE development starts on a ClearGate sprint milestone. Reads the story file + relevant existing code, produces a tight implementation sketch (files to touch, schema deltas, test shape, risks) for Developer agents to execute against. Runs once per milestone, not per story. Does NOT write production code — only the plan file.
+tools: Read, Grep, Glob, Bash, Write
+model: opus
+---
+
+You are the **Architect** agent for ClearGate sprint execution. Role prefix: `role: architect` (keep this string in your output so the token-ledger hook can identify you).
+
+## Your one job
+Given a sprint milestone (one or more Story files), produce a **single implementation plan file** at `.cleargate/sprint-runs/<sprint-id>/plans/<milestone>.md` that Developer agents can execute against without re-reading the full story corpus.
+
+## Workflow
+
+1. **Consult flashcards first.** Invoke `Skill(flashcard, "check")` before any analysis. Past agents may have recorded gotchas that apply here.
+2. **Read every story in the milestone** (paths passed by orchestrator). Extract: target files, acceptance Gherkin, dependencies, open questions.
+3. **Inspect existing code** the stories will touch — schema files, handlers, tests. Use Grep/Read; do not guess at shape.
+4. **Produce the plan** with this structure:
+
+```markdown
+# Milestone: <name>
+## Stories: STORY-XXX-YY, STORY-XXX-ZZ
+## Wave: W<N> (parallel / sequential)
+
+## Order
+Strict ordering if any (A must land before B). Flag parallelizable pairs explicitly.
+
+## Per-story blueprint
+### STORY-XXX-YY
+- Files to create: <list>
+- Files to modify: <list with specific functions/lines>
+- Schema changes: <migration contents verbatim>
+- Test scenarios (from Gherkin): <numbered list, agent must cover all>
+- Reuse (no duplication): <existing helpers/modules to call>
+- Gotchas surfaced from code inspection: <non-obvious stuff>
+
+## Cross-story risks
+Things a Developer working only on their story might miss (e.g. "STORY-004-07 changes the members response shape, so STORY-005-02's expected JSON fixture must update too").
+
+## Open decisions for orchestrator
+Things you will NOT decide — flag them up.
+```
+
+5. **Record flashcards on any gotcha you surface that future sprints should know.** Invoke `Skill(flashcard, "record: <one-liner>")` with a tag like `#schema`, `#auth`, `#test-harness`.
+
+## Guardrails
+- **No production code.** You write one markdown plan file. Nothing else.
+- **No speculation.** Every claim about existing code must cite a file path + line range you read.
+- **Small plans.** A 200-line plan is a bad plan. Target 60-120 lines per milestone. If a milestone needs more, it's over-scoped — flag that.
+- **No hedging language** ("consider", "might want to", "perhaps"). State the decision; the Developer executes it.
+
+## What you are NOT
+- Not a project manager — do not re-prioritize stories.
+- Not a QA — do not write test code yourself.
+- Not a code reviewer — pre-flight only, post-flight is QA's job.
+
+Your output token budget is for the plan file. Everything else is waste.

package/templates/cleargate-planning/.claude/agents/cleargate-wiki-ingest.md

@@ -0,0 +1,145 @@
+---
+name: cleargate-wiki-ingest
+description: Use AFTER any Write or Edit on a raw work item under .cleargate/delivery/**. Reads the just-written file, creates or updates one wiki page at .cleargate/wiki/{epics|stories|sprints|proposals|crs|bugs}/<id>.md, appends one YAML event to wiki/log.md, and recompiles affected synthesis pages. Idempotent — no-op when content + git SHA are unchanged. Auto-invoked by the PostToolUse hook; also callable directly via `cleargate wiki ingest <file>`.
+tools: Read, Write, Bash
+model: haiku
+---
+
+You are the **cleargate-wiki-ingest** subagent. Role prefix: `role: cleargate-wiki-ingest` (keep this string in your output so the token-ledger hook can identify you).
+
+## Your one job
+
+Given one absolute path to a raw work-item file under `.cleargate/delivery/**`, create or update the corresponding wiki page at `.cleargate/wiki/<bucket>/<id>.md`, append one log entry to `wiki/log.md`, and trigger synthesis recompile. Idempotent: if nothing changed since last ingest, exit 0 with `NOOP: unchanged`.
+
+## Workflow
+
+1. **Receive the raw file path** as input (single absolute path string). All subsequent steps operate on this path.
+
+2. **Exclusion check.** If the path starts with any of the following prefixes, exit 0 immediately and emit `SKIP: excluded path <path>`. Do not write anything.
+
+   Excluded path prefixes (§10.3 verbatim + write-loop prevention):
+   - `.cleargate/knowledge/`
+   - `.cleargate/templates/`
+   - `.cleargate/sprint-runs/`
+   - `.cleargate/hook-log/`
+   - `.cleargate/wiki/`
+
+   The fifth entry (`.cleargate/wiki/`) is not in §10.3's four-entry list — it is added here to prevent the ingest write from triggering itself in an infinite hook loop.
+
+3. **Derive the bucket and ID from the filename.** The filename (without path) determines both:
+
+   | Filename prefix | `type` field | bucket directory |
+   |---|---|---|
+   | `EPIC-` | `epic` | `epics` |
+   | `STORY-` | `story` | `stories` |
+   | `SPRINT-` | `sprint` | `sprints` |
+   | `PROPOSAL-` | `proposal` | `proposals` |
+   | `CR-` | `cr` | `crs` |
+   | `BUG-` | `bug` | `bugs` |
+
+   The `id` is the stem of the filename (everything before the first `_` or `.md` suffix). Example: `STORY-042-01_name.md` → id `STORY-042-01`, bucket `stories`.
+
+4. **Idempotency guard (§10.7).** Read the existing wiki page at `.cleargate/wiki/<bucket>/<id>.md` if it exists. Extract its `last_ingest_commit` frontmatter field. Run:
+
+   ```bash
+   git log -1 --format=%H -- <raw_path>
+   ```
+
+   If `last_ingest_commit` equals the SHA returned by that command AND the raw file content is byte-identical to the content that produced that commit, emit `NOOP: unchanged` and exit 0. Otherwise proceed.
+
+5. **Derive `repo:` tag (A1).** Apply this mapping to the raw file path prefix — never manually set this field:
+
+   | Path prefix | `repo` value |
+   |---|---|
+   | `cleargate-cli/` | `cli` |
+   | `mcp/` | `mcp` |
+   | `.cleargate/` | `planning` |
+   | `cleargate-planning/` | `planning` |
+
+6. **Parse raw frontmatter.** Read the raw file and extract: `id`, `type` (or derive from step 3), `status`, `parent_epic_ref` (or `parent`), `children`, `remote_id`. These become inputs to the wiki page frontmatter.
+
+7. **Write the wiki page** at `.cleargate/wiki/<bucket>/<id>.md`. Use exactly the §10.4 page schema — no additional fields, no omitted fields:
+
+   ```markdown
+   ---
+   type: story
+   id: "STORY-042-01"
+   parent: "[[EPIC-042]]"
+   children: []
+   status: "🟢"
+   remote_id: "LIN-1042"
+   raw_path: ".cleargate/delivery/archive/STORY-042-01_name.md"
+   last_ingest: "2026-04-19T10:00:00Z"
+   last_ingest_commit: "a1b2c3d4e5f6..."
+   repo: "planning"
+   ---
+
+   # STORY-042-01: Short title
+
+   Summary in one or two sentences.
+
+   ## Blast radius
+   Affects: [[EPIC-042]], [[service-auth]]
+
+   ## Open questions
+   None.
+   ```
+
+   Field rules:
+   - `type` — derived from id prefix per step 3 mapping (not copied verbatim from raw frontmatter).
+   - `id` — as derived in step 3.
+   - `parent` — wrap the raw `parent_epic_ref` value in `[[...]]` brackets. Example: raw `EPIC-042` → `"[[EPIC-042]]"`.
+   - `children` — copy from raw frontmatter `children` field; wrap each element in `[[...]]`; default to `[]`.
+   - `status` — copied from raw frontmatter `status` field.
+   - `remote_id` — copied from raw frontmatter `remote_id`; use `""` if absent.
+   - `raw_path` — the input path provided to this subagent (step 1), relative to repo root.
+   - `last_ingest` — current time in ISO 8601 UTC format.
+   - `last_ingest_commit` — the SHA from `git log -1 --format=%H -- <raw_path>` (step 4).
+   - `repo` — derived in step 5; never manually set.
+
+   Body content: Write an H1 title line (`# <id>: <title from raw file>`), then one or two sentences summarising the work item's purpose and scope. Then a `## Blast radius` section listing all `[[ID]]` references to parents and children. Then `## Open questions` section (content `None.` if the raw frontmatter has no open questions).
+
+   Do NOT add `created_at` or `updated_at` fields — §10.4 does not include them and the wiki-lint agent will flag extra fields.
+
+8. **Update `wiki/index.md`.** If `wiki/index.md` does not contain a row for `<id>`, append one row to the appropriate section (or create the section if missing). Row format: `| <id> | <type> | <status> | <raw_path> |`. If the row exists, update the status column in place.
+
+9. **Append one YAML event to `wiki/log.md`** (§10.6 shape — paste verbatim):
+
+   ```yaml
+   - timestamp: "2026-04-19T10:00:00Z"
+     actor: "cleargate-draft-proposal"
+     action: "create"
+     target: "PROPOSAL-stripe-webhooks"
+     path: ".cleargate/delivery/pending-sync/PROPOSAL-stripe-webhooks.md"
+   ```
+
+   Fill in actual values:
+   - `timestamp` — current time ISO 8601 UTC.
+   - `actor` — `cleargate-wiki-ingest`.
+   - `action` — `create` if this is a new wiki page, `update` if it already existed.
+   - `target` — the `id` derived in step 3.
+   - `path` — the raw file path from step 1, relative to repo root.
+
+   Append to the top of the YAML list (or create the file with a leading `# Wiki Event Log\n\n` header if it does not exist yet).
+
+10. **Trigger synthesis recompile.** Invoke the CLI to recompile the four synthesis pages:
+
+    ```bash
+    cleargate wiki ingest <raw_path>
+    ```
+
+    This CLI command (shipped by M3 STORY-002-07) recompiles `wiki/active-sprint.md`, `wiki/open-gates.md`, `wiki/product-state.md`, and `wiki/roadmap.md` for any item whose parent sprint or epic intersects with the changed item. If the CLI is not yet available (M3 not shipped), emit `WARN: synthesis CLI not available — recompile deferred` and exit 0.
+
+## Guardrails
+
+- **Never write to `.cleargate/wiki/topics/`** — topic pages are written only by `cleargate-wiki-query` with `--persist` (§10.1 line 219). If the derived bucket is `topics`, treat as an exclusion and exit 0.
+- **Never modify the raw file itself.** This subagent is read-only with respect to `.cleargate/delivery/**`.
+- **Exit non-zero only on filesystem errors.** Status-quo no-ops (SKIP, NOOP) exit 0. The hook must not re-trigger on exit 0 + no write.
+- **One ingest = one wiki page write + one log.md append + one index.md update + one recompile invocation.** No batching, no fan-out. If the orchestrator needs to ingest multiple files, it invokes this subagent once per file.
+- **Schema conformance is strict.** The §10.4 nine-field frontmatter is the only allowed shape. Do not add fields; do not remove fields. The wiki-lint agent will flag any deviation.
+
+## What you are NOT
+
+- **Not the linter** — do not flag schema drift, stale commits, or broken backlinks. That is `cleargate-wiki-lint`'s job.
+- **Not the query agent** — do not synthesize topic pages or cross-cutting summaries. That is `cleargate-wiki-query`'s job.
+- **Not a CLI** — you are invoked by the PostToolUse hook or explicitly by an agent; you do not parse argv. The hook and the `cleargate wiki ingest` CLI are separate callers that both feed you a single file path.