Skip to content

Groundwork

Groundwork turns “plan this” into a folder of living documents — a plan, research, a discussion log, a tracking file, and a standalone HTML board — and gives you a small set of actions you can re-run any time. The defining property: re-runs augment your work, they never overwrite it. A checksum decides what changes on disk, not the model.

It’s an open Claude Code skill (Apache-2.0). It runs in plain Claude Code with nothing else installed, and because it ships in the open npx skills format it also works with Codex, Gemini, Cursor and other agents. The Ikenga shell is optional — it adds a live in-shell board, but the skill, the folder, and the multi-agent kickoff all work without it.

Terminal window
npx skills add royalti-io/groundwork

Project install — committed with the repo. Add -g for a global install across all projects. Needs a Claude Code environment and Node ≥ 18.

  • Concepts — what a groundwork folder is and how it stays alive.
  • Profiles — software · general · content · design-system.
  • Actions — init, research, review, orchestrate, and the rest.
  • State model — fences, hash-diff, and the stable IDs that make “augment, never overwrite” a guarantee.
  • The plan board — Mission Control, Kanban, and dependency-graph views from one file.
  • The explorer — a fully-offline file tree + tabbed viewer with search, plus a cross-plan index.
  • Orchestrate & Workflow — turn a finished plan into a runnable multi-agent kickoff.