adopt
Use when an existing project that was not built with X2 must be migrated to run under it, with documentation sprawl to dissolve, stories to harvest at epic…
Use after the repo is seeded to run the D-000 five-lens decomposition, record persistent schema decisions, define slice one, and start the deltas file. Also use when a stays-ahead decision (decomposition, schema) must be revisited. Do not use for per-slice implementation
$ npx -y skills add teklabsdigital/x2-method --skill decompose --agent claude-codeHow it fires
How this skill gets triggered: by you, by Claude, or both.
/decomposeContext preview
The summary Claude sees to decide when to auto-load this skill.
Use after the repo is seeded to run the D-000 five-lens decomposition, record persistent schema decisions, define slice one, and start the deltas file. Also use when a stays-ahead decision (decomposition, schema) must be revisited. Do not use for per-slice implementation
name: decompose description: Use after the repo is seeded to run the D-000 five-lens decomposition, record persistent schema decisions, define slice one, and start the deltas file. Also use when a stays-ahead decision (decomposition, schema) must be revisited. Do not use for per-slice implementation decisions; those are D-0xx record-gaps raised during implement.
The one place where the model's whole-solution-space view beats the human's slice-by-slice view, and the decisions a slice cannot cheaply reverse. Everything else stays reversible and waits.
Decompose the story set under five imposed lenses, one pass each, no code: data flow, failure domain, change frequency, team boundary, trust boundary. Look at what disagrees between the five decompositions; the disagreements are where the real shape decision lives. Choose a shape. Record the choice and the four rejected shapes with reasons as `D-000-decomposition.md` in `docs/decisions/`.
D-000 also records:
requirements document (the pilot's turn 8b defect was creating one).
turn, and every later migration is an unconditional human turn, every time.
Build scope and design scope are separate rulings: the build is slice-first, the design is whole-product (MET-03); record both.
Applies when the product will ship to a public audience; rule each concern IN or OUT now, so none of it arrives as ad-hoc directives at the end (record: NS-2, NS-3):
domains, policies, analytics) that is not greenfield?
ruled before first use, never assumed; an assumed value propagates into green artifacts and surfaces late.
AI-readability), analytics, abuse pricing, and edge hardening.
Also read the cross-project churn table in the method's `record/negative-space.md`: it names the decision types history says will churn. Pre-decide the pre-decidable ones here; budget the iteration-inherent ones (story refinement, model selection, content voice) instead of fighting them. For the marked chronic churn types, record a confidence and a "wrong-if" line on the decision so reality can trip it later.
Start `deltas.md`: how this project differs from the edition it was seeded from, which the kernel-provenance row names. It grows as the build surfaces differences; it never restates what that edition already says.
decisions and are not counted in the per-slice metric.
vocabulary rides alongside, never instead. A ruling made on a summary the owner cannot parse on first read is no ruling at all (P3).
module boundary, not the internals.
design, carrying D-000 and the behaviour spec.
An agentic software engineering method: AI agents do the building, the build enforces the rules that must always hold, a person decides only at the gates, and the method measures its own cost in human turns.
Repo: teklabsdigital/x2-method
Use when an existing project that was not built with X2 must be migrated to run under it, with documentation sprawl to dissolve, stories to harvest at epic…
Use only after the lock (gate 2b) is on record for the slice portion, to derive the fidelity ledger and acceptance scenarios from the locked prototype.…
Use when D-000 exists and the whole-product prototype does not, to run Claude Design in its own context and produce the prototype and design system. Also use…
Use when an X2 project completes (or reaches a major milestone) to run the extraction loop, the quality feedback that folds the project's evidence back into…
Use when someone asks what an X2 skill does, which skill to run next, how the gates work, or where an artifact lives. A quick in-flight reference; for the…
Use when the slice portion is locked and its derived tests exist, to build all of the locked portion to green autonomously. Triggers at implement start and on…