stark-build

Implements an accepted spec autonomously with fresh writers, deterministic gates, and one advisory review.

Updated Mar 16, 2026
One-click install
npx skills add https://github.com/21StarkCom/stark-skills --skill stark-build-21starkcom
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: stark-build
Source: https://github.com/21StarkCom/stark-skills/tree/main/runtime-overrides/codex/skill/stark-build
Command: npx skills add https://github.com/21StarkCom/stark-skills --skill stark-build-21starkcom

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Autonomous code generation often produces unverified or gamed results: agents claim completion without passing tests, edit the very checks meant to grade them, or loop endlessly on reviewer feedback. This Skill turns an accepted spec into verified commits by making completion a runnable pass/fail check that the implementing agent can never modify. ## Core Features & Use Cases - Isolated writer per task: Dispatches one fresh Claude, Codex, or Gemini session per spec task, with runner-owned state kept outside the writer's writable root and tamper detection via before/after manifests. - Deterministic verification gates: Runs each task's done-when command itself, commits only green tasks, and treats an explicit abort marker as a first-class success instead of a faked green. - Bounded review and fix: Runs exactly one cross-vendor advisory review on the final diff, then at most one fix round for medium+ findings, keeping the PR draft whenever anything stays open. - Use Case: After gating a feature spec with the stark-author skill, hand the spec path to this Skill and receive a draft PR containing one commit per verified task, evidence logs, and posted advisory findings. ## Quick Start Run the stark-build skill on my accepted spec at specs/2026-01-15-auth-flow-spec.md and open a draft PR with the verified commits.

Frequently Asked Questions about stark-build

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I run an autonomous build from a spec file?▼

Invoke the skill with the path to a spec that contains an accepted-base commit header, for example with optional flags like --dry-run or --agent claude. The runner parses the task list, dispatches one fresh writer per task, and commits each task only after its done-when check passes.

How does the skill prevent AI agents from faking completed tasks?▼

Completion is defined as a runnable check executed by the runner, never a model verdict. Checks and existing tests live in a protected-path list enforced by hooks and post-dispatch diff comparison, so a writer that edits its own gate aborts the run.

Which AI coding agents are supported as task writers?▼

The dispatch fallback supports the Claude, Codex, and Gemini headless CLIs, selected with --agent auto|claude|codex|gemini. Claude receives hook-based path protection, while other writers rely on workspace isolation plus the runner's before-and-after state manifest comparison.

Why does the build stop instead of retrying when a task fails?▼

A crashed task is re-dispatched exactly once, resuming from progress and commits rather than zero. If it still fails, the runner logs a blocked deviation and moves on, because measured data shows repeated attempts increase cheating rather than fix rates.

Does the advisory code review loop until all findings are fixed?▼

No. The skill runs exactly one cross-vendor advisory review and at most one fix round covering critical, high, and medium findings. Anything still open after that round stays on the draft PR for the human to decide.

What happens if the final end-to-end verification fails?▼

If all tasks are green but the spec's held-out verification command is red, the runner logs the divergence, keeps the PR as a draft, and reports it plainly. There is no automatic fix loop for end-to-end failures.