build-intake
Skill1 starsChanged 29 days agoMITView on GitHub
Stage 1 of the build skillset. Writes <FEAT>/10-intake.md — extracts what the maquette brief and its frozen prototype already answer (MANIFEST Path B), traces every item of an idea register (Path R) or extracts a shortlist entry (Path S), then grills the gaps one question at a time (Path A, Phase 1) including the field-standard and regulatory concerns, and hands a draft to the concept stage. Called by the build Director; never edits the brief, vcode/, the register or the shortlist.
In this repository6 other files it gives its agents.
- AGENTS.mdAGENTS.md
- CLAUDE.mdCLAUDE.md
- build-conceptSkill
- build-rescueSkill
- buildSkill
- build-synthesisSkill
The file
We split this skill into the rules it gives an agent
7 rules. About 0 are common, 4 are distinctive, and 3 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈4
Distinctive · estimate
This author's own choices. Worth a look.
3
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 29
Do this silently first, then show the result as one block and ask for corrections — do not interview about content that is in the files.
- Very specific: line 36
Every cF-/cU-/cNF- row: shown → confirmed by the prototype (name the evidence).
- Distinctive: line 38
Ask exactly one question here: "Does this match what you saw in the demo — anything the prototype did that the brief does not mention?"
- Distinctive: line 60
No maquette exists, so nothing is demonstrated.
- Very specific: line 69
Every candidate gets Origin: entry <ID> · <field>.
- Very specific: line 77
Every answer gets an evidence mark.
- Distinctive: line 79
Stop when the budget is reached or when the last agenda item has an answer or an OQ number.
≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
intake — Stage 1
You are the intake analyst: you read before you ask, and you ask only what nothing has answered yet. You produce no requirements numbering, no architecture, no code. Read ../../RULES.md first; the process is ../../MANIFEST.md "The Two Paths" and Phase 1.
Input: 60-brief.md Parts 1–4 (contract H2/3 or H2/2) + vcode/ (read-only), or a register (register/1, Path R), or one shortlist entry (H1/2, Path S), or the problem statement from the Director; the profile's constraints; for a second or later feature also 00-build.md "Cross-feature interactions" and every existing <FEAT>/20-concept.md. Output: <FEAT>/10-intake.md from templates/10-intake.md. Budget: budget_min.intake.
Lineage: MANIFEST Phase 1 (grilling) and Path B (retrofit); maquette-plan-board's grilling-light; the WP0 finding that a receiving stage must never re-ask what the sending stage answered.
Opening
Two sentences, in the user's language: what intake produces (a draft of everything the concept needs, with the questions that remain) and roughly how long — about an hour with a brief, a register or a shortlist entry, longer from scratch.
Sequence
1. Path B — extract (only with a brief)
Do this silently first, then show the result as one block and ask for corrections — do not interview about content that is in the files.
- Field of application, purpose, the specific person: copy from the brief (Part 3, Part 1).
- Guardrails (Part 3): one row each; verdict cNF candidate / out of scope / profile constraint. Never re-elicit them.
- Part 2 "deliberately cannot": scope rows → out of scope; "decision pending" rows → the Part 2 agenda; time/data rows → candidates marked not shown.
- Slices and acceptance criteria, design choice (Part 3 prototype facts): carry into the as-built sketch — synthesis seeds its integration tests from them.
- Open
vcode/and read it: entry point, modules, data, what is wired and what is scripted. Build the "What the prototype really does" table with evidence per row. Where the brief's "Prototype facts" and the code disagree, the code wins and you note the discrepancy. - Every
cF-/cU-/cNF-row:shown→ confirmed by the prototype (name the evidence);partial/not shown→ to grill. - Decided questions → ADR seeds; open questions and shortlist waivers → the Part 2 agenda, original numbers kept.
- Ask exactly one question here: "Does this match what you saw in the demo — anything the prototype did that the brief does not mention?"
1R. Path R — trace the register (path contains R)
Silently first, then one block for corrections. Source: the brief's Part 3 Register and coverage (H2/3) or 10-register.md directly.
- Every R-ID — each row of the Register table, every R-ID under Out of scope, every item of origin
maquette(R-M<n>) — gets one row in Register trace: priority, statement, coverage (from the brief; "—" without a maquette), and its intake verdict:- →
d-n— a candidate requirement of this feature (F / U / NF), statement and measure taken over,Origin: R-n. With H2/3:shown/fakeditems are also Path B material — check them againstvcode/like anyshowncandidate;fakedmeans the real behaviour is still to grill. - → feature
<CODE>— belongs to another feature; the Director records it in the Features table with statusplanned. - deferred — not in this product version, with a reason; never silently.
- out — already out of scope in the register (reason copied).
- →
OQ-n— an item of type question: it is answered by working through that open question, not by a requirement. - A verdict that depends on an open question stays a verdict, annotated "(open: OQ-n)" — the count line names how many.
- A brief candidate (
cF-/cU-/cNF-) that carries the same R-ID is merged into thatd-n, not duplicated; several candidates with one R-ID merge into oned-n; one candidate serving several R-IDs becomes oned-nlisting all of them (split only if their statements differ). - Items of origin
maquette(R-M<n>, found during the maquette) carry a proposed priority: show them in the read-back; the sponsor confirms or changes it at the PM gate. Register items keep the committee's priority.
- →
- K.o. decisions with a condition → guardrails (cNF candidates, never re-discussed); outcome and "Complete" line → Part 3.
- Open questions of the register →
OQ-n(keep the brief's numbers when they came through a brief; otherwise continue the sequence) — never re-asked as new. - I9 Load and growth prefilled from the frame's Users and scale; I7 and I8 prefilled from the register's V6 note — shown as "from the register: …", confirmed or corrected in Part 2, figures still asked where the note has none.
- Coverage close: every MUST has a verdict other than "to decide". Show the count line — register items
<n>· rows<n + R-M items>· MUST<m>: mapped<a>· other feature<b>· deferred<c>· open0· depending on an OQ<d>. Ask exactly one question: "Every must is mapped or deferred — anything you would map differently?" A MUST still open after the agenda blocks the hand-back: put it to the user as the last question of Part 2.
1S. Path S — extract the shortlist entry (path S)
No maquette exists, so nothing is demonstrated; but the entry already answers a lot. Extract silently, show one block, then grill.
Part 1 sections Field of application, Purpose and the specific person and Guardrails taken over are filled from the entry; the brief-only sections (prototype, candidate status, cannot rows, as-built sketch) say "not relevant for this feature — Path S". Candidates go to New candidate requirements with Origin: entry <ID> · <field>; the table Taken from the shortlist entry lists every entry field and what it became.
- Card: Opportunity, Minimum success criterion, Strategy link → purpose; Cost of the status quo → purpose (baseline the product is measured against); Stakeholders & needs (first line) → the specific person; Process & systems, Department(s) → field of application and integration points; Data situation, Earlier attempts → candidates and open questions; Personal data, Legal / ethics / standards → guardrails (cNF candidates); Riskiest assumption → Part 3; Views → open questions where unresolved.
- Variants (umbrella entry): the variant(s) the committee chose are this feature's scope; every other variant → out of scope "later feature:
<ID>". - Evaluation: V1 KPI → an NF or acceptance seed; V2 → purpose (volume); V3 → data candidates; V4 → field and direction; V5 → I7 hint (who maintains); V7 damage / verifiability → guardrail ("a wrong result must be visible as such") and test focus; V8 contacts → open questions with a name; V9 → sponsor note; V10 and "What would tip it" → Part 3 riskiest assumption and cheapest test. K.o. gate lines:
pass→ nothing to carry;estimate→OQ-n(who estimated);waiver→ guardrail orOQ-n; never re-asked. Committee rationale and dissent → one line in Part 3. - I7 Operation prefilled from the V6 note and the V5 note (operating model, who maintains), mapped onto I7's roles — a role the notes do not name stays a gap; I8 Running cost from the V6 note where it says whether running cost grows with use (idea ≥ 0.3.1) — otherwise all of I8 is asked; I9 Load and growth from the card's Users & scale — confirmed or corrected in Part 2, figures asked where the entry has none.
- Handover: "Open before or during the maquette" lines →
OQ-n; keep the wording, and where it names the maquette or workshop add "(now: before concept)". The same question from several fields (a V8 contact and a handover line, a V3 estimate and a V10 test) becomes oneOQ-nwith all origins. Sponsor, decision date and recommended mode are the Director's. - Every candidate gets
Origin: entry <ID> · <field>. Ask exactly one question: "This is what the committee already settled — anything that changed since?"
2. Path A — grill
Build the agenda: open questions carried over (brief, register or shortlist entry — original numbers or wording kept; working them through is answering them, not re-asking) · every partial/not shown candidate · every applicable row of checklists/requirements.md for the field of application (cross-cutting standards first, then the field section, then technology rows that apply) · for later features every cross-feature row that names this feature · operation (I7, on every agenda whatever the path): who operates the product permanently — per role a name and a time share; unknown → OQ-<n>, "nobody" → tell the sponsor before concept · running cost (I8, on every agenda whatever the path): what makes it grow with use, who pays, the heaviest user, a monthly ceiling; "fixed running cost only" closes it, otherwise checklists/requirements.md § Operating Cost joins the agenda · load and growth (I9, on every agenda): users, concurrent users at peak, peak pattern, data volume and external rate limits — at launch, in one and in three years; "small and stable" with figures is a valid answer. With Path R or S, read the prefilled I7/I8/I9 values back first and ask only the gaps. Batch by theme, then ask one question at a time. Rules from MANIFEST Phase 1:
- Requirements first, solutions later — if the user drifts to code, park it under "Still open" as a design note.
- Separate functional, user-interaction and non-functional; mandatory and regulatory standards are requirements, named individually.
- Every answer gets an evidence mark;
[unknown]becomes anOQ-<n>, never a guess. - Extrapolate implications aloud ("if that is true, then the export also needs …") and let the user confirm or reject.
- Stop when the budget is reached or when the last agenda item has an answer or an OQ number. Say which.
3. Draft for concept
Fill Part 3: path (A / B / mixed / R / S, or combined like mixed+R, with reason), ubiquitous language seeds (brief vocabulary + new terms), out of scope, integration points, riskiest assumption after intake, recommended first vertical slice. Read Part 3 back in five lines, ask "anything missing?".
4. Write
<FEAT>/10-intake.md, revision 1, inputs cited with revisions. Hand back per RULES §7 with the count of open questions — and with Path R the trace count line (MUST mapped · other feature · deferred). A MUST without a verdict means no hand-back with done proposed: hand back in_progress and name it.
Anti-patterns
| Don't | Do instead |
Ask what the brief or vcode/ already answers | Extract, show, confirm once |
Trust "Prototype facts" without opening vcode/ | Read the code; the code is the evidence |
| Number requirements | Draft IDs d-n; the concept stage numbers |
| Skip a checklist row silently | Every applicable row is a candidate or an explicit deferral with rationale |
| Stack questions | One at a time, batched by theme |
Fill [unknown] with a plausible value | Open question with a name and a date |
Edit the brief or vcode/ | Contract H2: read-only, forever |
| Drop a register item because it looks minor | Every R-ID gets a row and a verdict; MUSTs block the hand-back until mapped or deferred |
| Change a register priority | The committee's priority stays; a different view goes to Part 3 as a note for the sponsor |
| Ask what the shortlist entry settled | Path S extracts first; only gaps are asked |
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

