Skip to content

kvasanova/loomwork

Repository files navigation

loomwork

One loom, one status surface. SDD lifecycle glue for running superpowers and compound-engineering in one repo without the conflict: a status-frontmatter convention, a drift audit, a pre-merge close-out procedure, and hook gates that enforce both.

Why

superpowers is an execution engine with no roadmap anchor, no solved-problem knowledge base, and no document-review pass. compound-engineering has those, but a looser execution pipeline. Installed together they collide: two brainstorm→plan pipelines, two status surfaces that drift apart. loomwork is the integration doctrine as a plugin:

  • One status-tracking surface. Spec frontmatter + acceptance checkboxes are the only "what's built" tracker. No second tool buys a sync engine — only a second source of truth that drifts.
  • Cherry-pick, don't merge. From compound-engineering take exactly: ce-strategySTRATEGY.md (roadmap anchor), ce-compounddocs/solutions/ (knowledge base), ce-doc-review (adversarial design review). Don't run ce-brainstorm → ce-plan → ce-work — superpowers is the execution engine.
  • Plans freeze, specs live. A merged plan gets a DONE banner and stops changing; the spec stays current as the code evolves.

Full doctrine: references/PLAYBOOK.md.

Install

/plugin marketplace add kvasanova/toolshed
/plugin install loomwork

Requires the superpowers and compound-engineering plugins (loomwork checks and tells you how to install them). Then, in each repo:

/loomwork:init

Scaffolds the docs layout, a STRATEGY.md seed, Cursor hook mirrors, and a CLAUDE.md block. Idempotent. Non-default paths: create .loomwork.json (keys specsDir, plansDir, strategyFile) before running init.

What ships

Piece What it does
loomwork:audit skill Drift linter: closed issues on draft specs, merged PRs on unbannered plans, missing/stale verified dates. Exit 0/1/2. Not a CI gate by design.
loomwork:close-out skill Pre-merge procedure: freeze the plan, verify + update the spec, touch the strategy file — on the feature branch, same PR.
Hook gates (Claude Code) Inject STRATEGY.md when brainstorming/writing-plans starts; inject the close-out reminder when finishing-a-development-branch starts.
Cursor hook templates Same gates for Cursor (written into .cursor/ by init — Cursor reads hooks from the workspace, so the plugin is the installer, not the runtime). Covers slash-command invocations a Skill-only hook misses.
/loomwork:init Idempotent scaffolder + dependency preflight.

Compatibility

Pinned upstream skill names this plugin references: brainstorming, writing-plans, finishing-a-development-branch (superpowers); ce-strategy, ce-compound, ce-doc-review (compound-engineering). Re-checked on upstream majors. A renamed upstream skill makes a gate silently stop firing — if a gate goes quiet after an upstream update, check these names first.

Support posture

No SLA. This plugin exists because its author runs it on their own repos; breakage from upstream majors is fixed when it bites those repos, not on report. Issues may go unanswered. Price that in before adopting.

About

SDD lifecycle glue for superpowers + compound-engineering. One loom, one status surface.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors