/anchor-intake

name: anchor-intake
description: Interrogate a written engineering implementation brief before work starts. Use when a user brings a ticket, PRD, design note, or substantive engineering task brief and wants to begin implementation planning; force every fixed rubric element to be accounted, cite present/weak claims against the brief, surface gaps, solution-as-goal traps, contradictions, and questions, then emit an intent-level plan. Do not use for bare one-line requests, non-engineering artifacts, code diff review, bug fixing, or execution itself.

anchor-intake

Force the skipped move before execution: interrogate the written brief against a fixed engineering implementation rubric, then plan only after gaps and weak assumptions are visible.

Trigger Check

Use this skill when the user provides a substantial written engineering implementation brief: a ticket, PRD, design note, or task brief with enough text to interrogate before work starts.

Do not use it for a bare one-line request, an already precise command, a marketing brief, research proposal, prose draft, code diff review, bug fix, or implementation execution. For unsupported or too-thin artifacts, self-eject in one sentence and write no `.techne/plan/<slug>` output. If a captured artifact later proves unsupported, use `finalize --unscopable --reason ...`.

Boundary test: can you point to a user-authored written artifact and ask whether it names the engineering goal, users, measurable success threshold, scope, non-goals, inputs, data sources, dependencies, constraints, and acceptance method? If yes, use `anchor-intake`. If no, eject or ask for the brief first.

Forced Procedure

1. **Capture the brief.** Save the user-authored artifact verbatim. Run: `python3 skills/anchor-intake/scripts/intake_gate.py init --project <root> --plan <slug> --brief-file <path>`. 2. **Read the brief in full.** Do not fill the rubric from memory or from the user's surrounding chat if the value is not in the captured brief. 3. **Account every fixed rubric element.** For each of the ten elements, write one disposition in `.techne/plan/<slug>/intake.json`: `present` with citation and `valueItems`, `present-weak` with citation and a dependent question, or `gap` with a question or visible `modelDefault`. 4. **Surface traps and conflicts.** Add span-anchored `solution-as-goal` and `contradiction` findings whenever the brief implies them. Contradictions need two verified spans. 5. **Ask only dependent questions.** Every question must resolve an element or finding and carry a `planDelta`. Weak/gap questions must reference the weak span/value or the missing element label. 6. **Author intent-level steps.** Steps are not execution yet. Each step needs an `id`, `dependsOnAssumptions`, `dependsOnSteps`, `verifiableOutcome`, and at least one terminal step reachable from a root step. 7. **Check and repair.** Run: `python3 skills/anchor-intake/scripts/intake_gate.py check --project <root> --plan <slug>`. Fix structural failures by doing the missing intake work, not by padding JSON. 8. **Finalize.** Run: `python3 skills/anchor-intake/scripts/intake_gate.py finalize --project <root> --plan <slug>`. Relay the generated `intakeReport.json` to the user, especially gaps, weak elements, questions, solution-as-goal findings, contradictions, and warnings.

Script Contract

Artifacts are written under the target project:

.techne/plan/<slug>/
  brief.txt          # captured external artifact
  context.json       # computed by init
  intake.json        # authored by the reviewer/planner
  report.json        # computed by check
  plan.json          # computed by finalize
  intakeReport.json  # computed by finalize

Generated `.techne/` output belongs to target projects. Do not commit it to this repository.

Minimal `intake.json` shape:

{
  "schema": "techne.intake/1",
  "elements": {
    "data-sources": {
      "disposition": "gap",
      "questionIds": ["Q1"]
    }
  },
  "findings": [
    {
      "id": "S1",
      "kind": "solution-as-goal",
      "citation": {"offset": 16, "quote": "Build a Slack bot"}
    }
  ],
  "questions": [
    {
      "id": "Q1",
      "text": "Which data sources should the implementation read?",
      "resolves": ["data-sources"],
      "planDelta": {"adds": ["Bind implementation to the named source"]}
    }
  ],
  "steps": [
    {
      "id": "s1",
      "title": "Implement only the scoped behavior",
      "dependsOnAssumptions": ["goal-and-why"],
      "dependsOnSteps": [],
      "verifiableOutcome": "The scoped behavior can be verified by the acceptance method",
      "terminal": true
    }
  ]
}

Use [reference.md](reference.md) for the full JSON contract, fixed rubric, STOPLIST/RUBRIC-LABEL set, shape rules, warning semantics, and known weak spots.

Stop Conditions

• Stop before planning if there is no substantial written engineering brief.
• Stop before `finalize` if `check` reports blocking failures.
• Stop and use `--unscopable --reason` if the artifact is not an engineering

implementation brief or is too garbled/thin to interrogate honestly.

• Stop before executing the work. `anchor-intake` ends at a surfaced report and

intent-level plan; implementation belongs to the next workflow step.