firatcand
UserA multi-agent Claude Code framework for running role-based agents across GTM, product, design, and ops — with plans, project substrate, and a reinforcement loop that compounds learning.
Categories
Indexed Skills (32)
chief-of-staff
Workspace maintenance for a roster v1 workspace — create agents under a function, register new functions, and audit completeness. Wraps shell scripts in scripts/. Triggers when the user asks to scaffold or audit a roster workspace, or invokes the /chief-of-staff slash command.
dreamer
Off-hours reflection agent. Reads recent runs and feedback across all agents, detects recurring patterns, drafts lesson candidates, routes through HITL approval, and writes approved lessons to the agent's playbook. The only agent that writes to playbook files. Triggers when the user invokes /dreamer or asks to consolidate lessons from past work.
roster-orchestrator
Bootstraps roster workspaces. On chat session start, surfaces pending HITL items as a single banner. On a scheduled fire, verifies the schedule is registered, resolves the agent's merged env, dispatches the named agent via the host tool's native subagent primitive, writes a run log + state.md entry, and exits. Reads roster/<function>/schedules.yaml plus pending items at both roster/<function>/pending/ (error class) and <function>/<agent>/pending/ (lesson class). Subscription-billed primitives only — never invokes claude -p, claude --prompt, claude api, or the Anthropic SDK.
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.