Planning & Specification Workflows

Generate an AGENTS.md onboarding document for AI coding agents working in this repository. Inspects the repo (package manifest, README, scripts, lint/test config, layout, commit history) and writes a concise contributor guide titled "Repository Guidelines". Use when the user invokes /10x-agents-md, asks to "create AGENTS.md", "write an agent onboarding doc", "generate contributor guide for agents", or similar. The output is optimized to be small, precise, reference-heavy, and ordered with critical rules at the top — so a future agent reads it once and stays unblocked.

Archive a completed change by moving its folder into context/archive/ and stamping change.md with archived…

Scaffold a project into the current working directory after the tech stack has been picked. Reads context/foundation/tech-stack.md (the hand-off written by /10x-tech-stack-selector), looks up the chosen card in the starter registry, and runs its CLI through one of three cwd strategies (subdir-then-move, native-cwd, git-clone) with a strict conflict policy that always preserves context/. Two verification slots flank the scaffold: a light pre-scaffold recency check and a deeper post-scaffold audit. Writes a verification log to context/changes/bootstrap-verification/verification.md. Use when the user says "bootstrap the project", "scaffold the app", "set up the codebase", "let's start the project", or naturally follows /10x-tech-stack-selector. Use AFTER /10x-tech-stack-selector.

Drive an approved plan's browser-level (E2E) phases against the running…

Challenge framing assumptions about WHAT to build before planning HOW.

Run a health check on an existing project: dependency audit, security scan, test runner detection, CI/CD evaluation, and missing configuration analysis. Maps the three execution gates (pre/in/post) from /10x-bootstrapper to an assessment framework for existing codebases. Reads optional context/foundation/stack-assessment.md from /10x-stack-assess to focus checks on identified gaps. Writes context/foundation/health-check.md with findings, prioritized fixes, and an agent-readiness verdict. Use when the user has an existing project and wants to verify its health before working with an agent. Trigger phrases: "health check", "check my project", "audit my project", "is my project healthy", "sprawdź projekt", "audyt projektu", "health-check", "project health". Use AFTER /10x-stack-assess (brownfield chain), BEFORE agent onboarding (m1-l4).

Review implementation against plan for drift, dangerous decisions, and pattern…

Implement technical plans from context/changes/ /plan.md with…

Research and recommend an MVP deployment platform by combining tech-stack context, a short developer interview, and parallel web research scored against five agent-friendly platform criteria. Cross-checks the top recommendation through three anti-bias lenses (devil's advocate, pre-mortem, unknown unknowns) before writing context/foundation/infrastructure.md with a scored platform comparison, rationale, and risk register. Use when the user needs to pick a hosting / deployment / maintenance platform for an MVP and wants a well-researched, bias-checked decision rather than a gut call. Trigger phrases: "choose a platform", "where should I deploy", "infra research", "deployment platform for my MVP", "wybierz platformę", "gdzie deployować", "infrastructure decision", "hosting choice", "jaka platforma do deploymentu". Use AFTER /10x-prd or /10x-tech-stack-selector, BEFORE /10x-implement.

Initialize a new change folder under context/changes/ with a change.md identity…

Create detailed implementation plans with thorough research and…

Generate context/foundation/prd.md from shape-notes.md (or raw notes) against the locked PRD schema.

Research codebase comprehensively using parallel…

Generate context/foundation/roadmap.md from a PRD as an ordered set of vertical, end-to-end slices.

Review the condition of an "AI rules" file (CLAUDE.md, AGENTS.md, .cursor/rules/.mdc, .github/copilot-instructions.md, .windsurfrules, nested per-area rule files, or any other rule-for-AI markdown) and produce a 5-point scorecard with concrete, actionable fixes. Use when the user invokes /10x-rule-review with a path to a rules file, or asks to "review AI rules", "audit AGENTS.md", "check my CLAUDE.md", "score my agent instructions", "is this rules file healthy", or similar. The skill is agnostic to which tool the rules file targets — it scores the file as a rule-for-AI artifact, not as a project document.

Facilitate a structured discovery conversation that turns an idea — greenfield or brownfield — into shape-notes.md, the input to /10x-prd. Auto-detects context type from project markers in cwd (brownfield) or absence thereof (greenfield) and adapts all six discovery phases accordingly. Use when the user is starting a new project from scratch OR shaping a meaningful change to an existing system (new module, significant feature, architectural improvement). Trigger phrases: "new project", "from scratch", "starting an app", "od pomysłu", "shape an idea", "brainstorm a product", "greenfield", "I have an idea", "existing project", "brownfield", "istniejący projekt", "zmiana w projekcie". Use BEFORE /10x-prd, not in place of it.

Assess an existing project's stack for agent-friendliness using the 4 quality gates (typed, convention-based, popular in training data, well-documented) as an evaluation lens. Detects stack components from cwd, scores each against the gates, identifies compensation strategies for failures, and writes context/foundation/stack-assessment.md with per-component scores, gap analysis, and ready-to-paste CLAUDE.md/AGENTS.md entries. Use when the user has an existing project and wants to evaluate how well their stack supports AI agent workflows. Trigger phrases: "assess my stack", "evaluate my project", "is my stack agent-friendly", "oceń mój stack", "sprawdź projekt", "stack assessment", "brownfield assessment". Use AFTER /10x-prd (brownfield), BEFORE /10x-health-check.

Drive an approved plan from context/changes/ /plan.md phase by phase, test-first, through red→green→refactor — only for TDD'able phases not yet implemented; everything else routes to /10x-implement. Use when the user says "tdd", "test-first", "red green refactor", or wants to execute a plan via TDD.

Pick a starter and a stack for a greenfield project after the PRD is written. Reads context/foundation/prd.md, opens with a Q0 path-fork (recommended default for the (producttype, languagefamily) cell vs design-your-own), runs the residual interview on the custom path, reasons over a language-aware starter registry with four agent-friendly quality gates, and writes a context/foundation/tech-stack.md hand-off /10x-bootstrapper consumes. Use when the user asks "what stack should I use", says "pick a stack", "choose framework", "co wybrać do projektu", or has a PRD on disk and is ready to scaffold. Use AFTER /10x-prd, BEFORE /10x-bootstrapper.

Stateful, phased test-rollout orchestrator for existing products. Writes context/foundation/test-plan.md, then drives each rollout phase through /10x-new → /10x-research → /10x-plan → /10x-implement; re-running resumes from the next pending phase. Trigger phrases: "create test plan", "test strategy", "phased test rollout", "QA spec", "stwórz plan testów", "strategia jakości". Use AFTER /10x-prd and /10x-roadmap. Brownfield only.