Design
Propose shapes for something that does not yet exist and frame the decision — features, interfaces, architectures, migrations, policies. Use when the user wants options, an approach, a spec, an architecture, a prototype to answer a question, or when their intent is vague and needs eliciting. Read-only plus throwaway sandbox.From its SKILL.md
npx -y skills add jschilli/argot --skill designAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
2 things to look at
- no licenseNo license file was found in the repository. Code published without one is not open source by default, so using it at work is a question for whoever answers licensing questions where you are.
- 1 stars1 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
SKILL.md
1.8 KB, as published. Nobody here has run it
design — argot verb 2/7
Signature: intent → Design (.argot/design-*.md + .json, schema:
artifacts/design.schema.json): ≥2 options with tradeoffs, a falsifiable recommendation,
rejected alternatives recorded.
Envelope: read-only on the real codebase; throwaway sandboxes allowed (prototype-to-learn is design, not build — the code is disposable, the answer is the artifact).
Procedure
- Elicit if under-specified: interview the human — one question at a time, decisions from the human, facts from the codebase. Record the confirmed intent in the artifact.
- Ground: pull the relevant Briefs (or invoke
understandfor what's missing). Design against real code, not assumptions. - Diverge: produce ≥2 genuinely different options (not one option and a strawman). For
contested designs use
--panel N: independent candidates from different angles, cross-judge, graft the losers' best parts. - Converge: recommendation + rationale + what evidence would change it. Record rejected alternatives with why — that's the ADR half.
- Stop at the decision. The human decides. Do not proceed to
planuntil they have.
Contract
- Success = the human can decide without further research.
- A prototype's deliverable is the Design it informs; delete or quarantine the probe code.
- The
decisionblock of the artifact is filled only by the human, at the gate.