firatcand
UserA lightweight framework for shipping software products from idea to production with AI coding agents (Claude Code, Codex CLI, Cursor, Gemini)
Categories
Indexed Skills (29)
reconcile
Bidirectional sync between plans/phases.yaml and the configured tracker. --pull reads tracker → phases.yaml; --push writes phases.yaml → tracker bodies via updateIssueBody.
playwright-cli
Automate browser interactions, test web pages and work with Playwright tests.
amend-roadmap
Create a new task mid-flight — interactive field collection, then a tracker-first atomic amend (issue + relations on the tracker, materialized into phases.yaml via the reconcile pull path) with a resumable journal.
update-spec
Draft an ephemeral ADR for an in-flight architectural decision (--draft), then propagate the accepted decision to SPEC + PRD + phases.yaml + tracker bodies atomically (--apply <slug>) via the apply-decision verb's resumable journal.
draft-design
Generate spec/DESIGN.md for the project. Asks at init whether to create a project-owned design system or reference an external one (URL/file/brand-book) as a guideline. Each project owns its DESIGN.md — no inheritance.
forge-orchestrate
Per-round dispatch loop for forge's orchestrator. Lists ready tasks, asks user to approve, then claims, dispatches, and spawns worker subagents via the host's Task tool. Polls open questions and surfaces them for user answers. Suggest-don't-force — no automatic claim, no internal long-polling.
forge
Run forge's discovery interview over a product idea and produce a project BRIEF. Lightweight — 4 product/spec questions. The required first command for any new forge project.
implement
Execute the approved plan from /plan-task. Refuses to run without an approved plan unless --quickfix flag.
learn
Write a learning entry capturing what surprised us, what we'd do differently. Auto-suggested by /ship if task was notable.
pickup-task
Claim the next ready task from the configured tracker (Linear / GitHub Issues / Notion), create a git worktree, and inject relevant learnings.
plan-task
Run Plan mode for the current task. Outputs structured plan; required before /implement.
push-to-tracker
Push phases.yaml to the configured tracker (linear|github|notion) — creates project, per-phase grouping, issues with depends_on relations.
review
Run code-reviewer, security-auditor (if CRITICAL.md path touched), and design-reviewer (if UI task) on current diff.
second-opinion
Get a second opinion on a plan, diff, or specific files from Codex or Gemini (whichever is configured as `settings.agents.review_host_cli`). The reviewer reads the working tree directly, so it can reason about both the proposed change AND surrounding production code (dependency graph, sibling adapters, recently-merged PRs). Required for changes touching CRITICAL.md paths.
ship
Push branch, run final gates (tests, secrets scan, conventional commit), open PR with Linear issue ID, mark issue In Review.
status-check
Cold-start "where am I?" cockpit. Renders the cross-run orchestrator dashboard (active workers, open questions, ready vs blocked, overlap + lease health) and offers follow-up actions. Read-only; works standalone.
sync-status
Diagnostic that suggests when an active phase is ready for /phase-gate, and lists orphan tracker issues missing from plans/phases.yaml. Read-only — does not mutate phases.yaml.
codex
DEPRECATED — alias for /second-opinion. Removed in v0.5.0. Use /second-opinion instead; it dispatches to whichever reviewer (Codex or Gemini) is configured in `.forge/settings.yaml` agents.review_host_cli.
decompose
Break the validated spec into phases.yaml — a dependency graph of tasks across Phase 1/2/3 with gate criteria, owner types, and acceptance criteria.
draft-prd
Generate spec/PRD.md from spec/BRIEF.md with a per-feature discovery loop. Orchestrates the user's product-spec skill if available, otherwise guides Claude through the PRD template.
draft-spec
Generate spec/SPEC.md from spec/PRD.md. Orchestrates the user's software-architect skill if available, otherwise guides Claude through the SPEC template.
fix
Apply a fix based on /investigate output. Refuses to run without recent investigation.
ingest-spec
Validate that BRIEF, PRD, SPEC, and (optional) DESIGN are all complete and consistent. Build CONTEXT.md as canonical synthesis. Required before /decompose.
investigate
Iron Law of Investigation — required before /fix. Trace data flow, test hypotheses, identify root cause.
phase-gate
Ceremony to advance from phase N to phase N+1. Verifies gate criteria, runs end-to-end check, generates retro, prompts for human approval.
qa
Run test suite, browser checks, and verify acceptance criteria. Bootstrap test framework if missing.
retro
Write a phase retrospective. Auto-invoked by /phase-gate but can run standalone.
setup-repo
Bootstrap the GitHub repo for a forge project — repo creation, branch protection, GitHub Environments, CI workflows, secrets configuration.
push-to-linear
DEPRECATED — alias for /push-to-tracker. Removed in v0.4.0.
Bio shown is the top-scored skill's repo description as a fallback — real GitHub bios land in a future update.