three-pillars-plugin

Convene the Council of High Intelligence — multi-persona deliberation with historical thinkers for deeper analysis of complex problems.

Design Audit — multi-angle review of a detailed design against the actual codebase before implementation.

Mark a TDD design as complete — stamp completion, archive handoff.md, archive to three-pillars-docs/completed-tp-designs/, and optionally commit + open a PR merging the design branch back to the base branch.

Scaffold architecture.md, product_roadmap.md, and known_issues.md in three-pillars-docs/ from codebase analysis. Creates the three project docs that the TDD pipeline reads for context. Assumes three-pillars-docs/vision.md already exists — if missing, recommends /tp-setup first.

Read project docs and propose what to do next. Surfaces highest-impact work from roadmap, known issues, and in-flight designs.

Final audit of a completed plan — verify the full implementation against both design.md and detailed-design.md.

Sync a base branch INTO a design's worktree (base-sync) and auto-resolve the safe living-doc conflict classes behind a zero-drop verifier, deferring everything semantic to the human. Re-runs tests, re-pushes only when green, updates the PR. This is the reversible base-into-branch operation — landing the PR is the separate /tp-merge land gate.

Land a reviewed PR at the irreversible boundary: enforce the deterministic merge gate (require_merge_gate_pass — seven predicates incl. a current human approval, a fresh ci-local stamp, and a head-bound review-proof comment) and run the irreversible gh pr merge ONLY on PASS. Refuse on a blocked gate, printing the blocking predicate(s) and how to authorize. The base-into-branch base-sync operation is the separate /tp-merge-from-main skill.

Execute a phase from plan.md by running red-green-refactor cycles for each task. Spawns subagents for independent tasks within a phase.

Plan Audit — verify plan.md is consistent with design.md and detailed-design.md. Runs deterministic scripts then convenes an engineering council for judgment calls.

Generate a plan.md from detailed-design.md — a sequenced list of implementation tasks, each with test criteria, ready for /tp-phase-implement.

Post-merge teardown for a completed design. Verifies the completion PR is merged, then removes the design branch, sibling worktree, and MRU entry. The post-merge mirror of /tp-design-complete — the sole merge-verified lifecycle teardown path.

One-shot PR-fix worker — classify review comments, gate by reviewer identity, generate ONE structural-fix commit per round, push, and label. Composes into the `tp-pr-iterate` loop or runs standalone.

Autonomous PR-iteration loop driver — poll review comments, classify (heuristic + Sonnet), defer conflicting structural fixes, dispatch to `tp-pr-fix` per round, reply-and-resolve every thread, apply caps + guards, and terminate only at two-stable: both review sources quiet AND zero unresolved actionable threads verified against GitHub. Classifier-flip is necessary but not sufficient.

Promote a seed (seed.md) to a committed, floor-clearing design.md on the tp/<slug> branch, ready for a design-ready fleet pass. Reads the seed's Open questions, derives a single batched confirm block, collects one operator answer, drafts design.md, validates the floor, and hands off to /tp-run-full-design <slug> --skip-design (Mode B).

Revert a design landing: probe depth/forecast, apply git revert -m 1, carve out living docs, regenerate amendments, and land as a single-commit PR through the standard gate.

Autonomous full-design orchestrator. Drives the TDD pipeline unattended for a single task — pickup → design → worker → audits → PR — and produces a decision log for human review.

Restore session context from handoff.md in the design's directory at the start of a new conversation. Gives you continuity without re-explaining.

Conversational project setup. Draws out the project's 'why' into three-pillars-docs/vision.md — the first artifact every other TDD skill reads. Run this first on any new project.

Manage living spec deltas — scaffold, validate, and merge spec-delta.md files into domain base specs.

Capture spike findings and verdict into spike-results.md. Produces a structured record of what was learned, what demos were created, and what architecture decisions emerged.

Execute a single red-green-refactor TDD cycle. Human-invokable standalone, and also the kernel embedded by /tp-phase-implement for automated execution.

Configure test infrastructure for the TDD pipeline, informed by the project's stated architecture. Runs after /tp-docs-init so test-runner and layout choices are grounded in the documented system structure.

Produce a detailed-design.md from an existing design.md. Maps high-level entities and behaviors to concrete modules, interfaces, and test boundaries.

Synthesize a completed design's impact into project docs updates and identify affected sibling designs. The "close the loop" step after implementation-audit.

Interactive high-level design conversation that produces a design.md artifact in three-pillars-docs/tp-designs/{name}/. First step in the TDD pipeline.

Targeted update to vision.md, architecture.md, product_roadmap.md, and/or known_issues.md after a milestone. Shows diff-style proposals for user approval.

Print the in-flight design registry — every origin/tp/* design branch with its owner, phase, branch, age, and staleness — built live from the remote. Read-only, fail-open, no lock, no side effects. Use to see what other designs are in flight before you start work.

Migrate a three-pillars repo from the legacy docs/tdd-* layout to the current three-pillars-docs/tp-* layout. Wraps skills/_shared/migrate.py.

Autonomous spike pipeline — interactive design, then hands-off plan/audit/implement/results with a decision log for morning review.

Execute a spike from plan.md — serial exploration with human review gates at phase boundaries. Speed over ceremony.

Synthesize spike learnings into project docs updates and identify affected downstream designs. The "close the loop" step after spike-results.

Interactive spike design conversation that produces a spike-flavored design.md for time-boxed experiments. Optionally links back to a parent design.

Save structured session context to handoff.md in the design's directory for continuity across conversations. Use at end of a session or before switching phases.

Release your lock on a design without completing it. Use when you're stepping away and want a teammate to pick it up cleanly, without them having to --force-takeover.

Review what was built against the plan and design. Flags gaps, regressions, and deviations. Writes review.md.

Clear the handoff.md from a design's directory when switching to a completely different task. Prevents stale context from contaminating the next session.

Generate an experiment plan.md from a spike-flavored design.md — phases of hypothesis-driven tasks for exploratory work.