shape-concept
Skill18 starsChanged 3 months agoMITView on GitHub
Turn an accepted intake into concise canonical product intent without planning implementation.
In this repository5 other files it gives its agents.
- AGENTS.mdAGENTS.md
- concept-intakeSkill
- consolidate-stateSkill
- plan-implementationSkill
- sync-protocolSkill
The file
Show its rules and text
We split this skill into the rules it gives an agent
23 rules. About 0 are common, 18 are distinctive, and 5 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈18
Distinctive · estimate
This author's own choices. Worth a look.
5
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 8
Use this skill after concept intake or when accepted product intent must change deliberately.
- Very specific: line 13
Read every existing file in docs/concept/.
- Distinctive: line 16
Treat placeholder files as scaffolding.
- Distinctive: line 17
Treat accepted concept files as product authority.
- Distinctive: line 18
Treat intake as historical input during re-shaping.
- Very specific: line 25
Keep docs/concept/README.md as the concept index.
- Very specific: line 26
Use status Shaping during initial drafting.
- Very specific: line 27
Use status Re-shaping during deliberate revision.
- Distinctive: line 28
Avoid a fixed document taxonomy.
- Distinctive: line 29
Avoid one file per minor topic.
- Distinctive: line 30
Avoid duplicating a decision across files.
- Distinctive: line 42
Keep each discussion round focused on one tension.
- Distinctive: line 43
Ask for one material product decision at a time.
- Distinctive: line 46
Avoid detached research dumps.
- Very specific: line 50
Write only within docs/concept/.
- Distinctive: line 51
Update intake status only when the stage changes.
- Distinctive: line 52
Avoid choosing frameworks during concept shaping.
- Distinctive: line 53
Avoid choosing schemas during concept shaping.
- Distinctive: line 54
Avoid choosing deployment topology during concept shaping.
- Distinctive: line 55
Avoid turning open product questions into implementation discretion.
- Distinctive: line 56
Stop before implementation planning.
- Distinctive: line 57
Stop before product implementation.
- Distinctive: line 71
Ask the user to accept the shaped concept.
≈ “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
Shape concept
Use this skill after concept intake or when accepted product intent must change deliberately.
Start
- Read
docs/intake/concept-intake.md. - Read every existing file in
docs/concept/. - Require intake status
Ready for concept shapingfor initial shaping. - Require an explicit product-change request for re-shaping.
- Treat placeholder files as scaffolding.
- Treat accepted concept files as product authority.
- Treat intake as historical input during re-shaping.
- Return to concept intake when the intake is materially incomplete.
Document shape
- Choose the smallest useful concept document set.
- Give each concept file one ownership boundary.
- Keep
docs/concept/README.mdas the concept index. - Use status
Shapingduring initial drafting. - Use status
Re-shapingduring deliberate revision. - Avoid a fixed document taxonomy.
- Avoid one file per minor topic.
- Avoid duplicating a decision across files.
Drafting
- Synthesise the intake by meaning.
- Separate settled intent from assumptions.
- Separate evidence-backed findings from product judgements.
- Separate explicit exclusions from open questions.
- Cite factual claims with links or local sources.
- Mark unsupported product judgements as hypotheses.
- Preserve compatible human additions.
- Preserve unresolved non-blocking questions.
- Keep each discussion round focused on one tension.
- Ask for one material product decision at a time.
- Conduct research only when the user requests it.
- Fold approved research into the relevant concept file.
- Avoid detached research dumps.
Boundaries
- Write only within
docs/concept/. - Update intake status only when the stage changes.
- Avoid choosing frameworks during concept shaping.
- Avoid choosing schemas during concept shaping.
- Avoid choosing deployment topology during concept shaping.
- Avoid turning open product questions into implementation discretion.
- Stop before implementation planning.
- Stop before product implementation.
Completion
- Require a coherent problem definition.
- Require a coherent audience definition.
- Require a coherent desired outcome.
- Require coherent primary journeys.
- Require explicit scope boundaries.
- Require explicit non-negotiables.
- Require explicit exclusions.
- Require material domain rules.
- Require material contradictions to be resolved.
- Allow implementation-level unknowns to remain open.
- Ask the user to accept the shaped concept.
- Set concept status to
Ready for operational planningafter initial acceptance. - Set concept status to
Ready for operational re-planningafter re-shaping acceptance. - Set intake status to
Concept shapedafter initial acceptance. - Return a one-screen handoff summary.
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.

