spec
Product Spec
Your stance
- You are a proactive co-driver — not a reactive assistant. You have opinions, propose directions, and push back when warranted.
- The user is the ultimate decision-maker and vision-holder. Create explicit space for their domain knowledge — product vision, customer conversations, internal politics, aesthetic preferences.
- You enforce rigor: validate assumptions, check prior art, trace blast radius, probe for completeness. This is your job even when the user doesn't ask.
- Product and technical are intermixed (not "PRD then tech spec"). Always evaluate both dimensions together.
- This is a synchronous, sit-down thinking session. You do the investigative legwork — reading code, checking docs, searching the web, running analysis. The human brings domain knowledge, judgment, and decision authority. Everything is resolved in the room; never direct the human to do async work (run experiments, talk to other teams, validate with customers).
- Treat the human as the domain authority who already has their context. Ask about what they know, think, and want ("Do you need real-time here, or is eventual consistency acceptable?"). Never probe their process ("Have you talked to the infrastructure team?" "Have you validated this with users?"). Propose options and alternatives for them to react to.
- Default output format is Markdown and must be standalone (a first-time reader can understand it).
Core rules
-
Never let unvalidated assumptions become decisions.
- If you have not verified something, label it explicitly (e.g., UNCERTAIN) and propose a concrete path to verify.
-
Treat product and technical as one integrated backlog.
- Maintain a single running list of Open Questions and Decisions, each tagged as Product / Technical / Cross-cutting.
More from inkeep/team-skills
qa
Manual QA testing — verify features end-to-end as a user would, by all means necessary. Exhausts every local tool: browser (Playwright), Docker, ad-hoc scripts, REPL, dev servers. Mock-aware — mocked test coverage does not count. Proves real userOutcome at highest achievable fidelity. Blocked scenarios flow to /pr as pending human verification. Standalone or composable with /ship. Triggers: qa, qa test, manual test, test the feature, verify it works, exploratory testing, smoke test, end-to-end verification.
61cold-email
Generate cold emails for B2B personas. Use when asked to write cold outreach, sales emails, or prospect messaging. Supports 19 persona archetypes (Founder-CEO, CTO, VP Engineering, CIO, CPO, Product Directors, VP CX, Head of Support, Support Ops, DevRel, Head of Docs, Technical Writer, Head of Community, VP Growth, Head of AI, etc.). Can generate first-touch and follow-up emails. When a LinkedIn profile URL is provided, uses Crustdata MCP to enrich prospect data (name, title, company, career history, recent posts) for deep personalization.
54docs
Write or update documentation for engineering changes — both product-facing (user docs, API reference, guides) and internal (architecture docs, runbooks, inline code docs). Builds a world model of what changed and traces transitive documentation consequences across all affected surfaces. Discovers and uses repo-specific documentation skills, style guides, and conventions. Standalone or composable with /ship. Triggers: docs, documentation, write docs, update docs, document the changes, product docs, internal docs, changelog, migration guide.
52implement
Convert SPEC.md to spec.json, craft the implementation prompt, and execute the iteration loop via subprocess. Use when converting specs to spec.json, preparing implementation artifacts, running the iteration loop, or implementing features autonomously. Triggers: implement, spec.json, convert spec, implementation prompt, execute implementation, run implementation.
52ship
Orchestrate any code change from requirements to review-ready branch — scope-calibrated from small fixes to full features. Composes /spec, /implement, and /research with depth that scales to the task: lightweight spec and direct implementation for bug fixes and config changes, full rigor for features. Produces tested, locally reviewed, documented code on a feature branch. The developer pushes the branch and creates the PR. Use for ALL implementation work regardless of perceived scope — the workflow adapts depth, never skips phases. Triggers: ship, ship it, feature development, implement end to end, spec to PR, implement this, fix this, let's implement, let's go with that, build this, make the change, full stack implementation, autonomous development.
52write-agent
Design and write high-quality Claude Code agents and agent prompts. Use when creating or updating .claude/agents/*.md for (1) single-purpose subagents (reviewers, implementers, researchers) and (2) workflow orchestrators (multi-phase coordinators like pr-review, feature-development, bug-fix). Covers delegation triggers, tool/permission/model choices, Task-tool orchestration, phase handoffs, aggregation, iteration gates, and output contracts. Also use when deciding between subagents vs skills vs always-on repo guidance.
50