x-create-product
Transform an ideation file into a Product artifact with RNF roots and C1 capability stub.
- License 许可
- MIT
- 最近更新
- 2026-10-27
- Stars
- ★ 0
- Forks
- 1
01 前言 Front Matter
- name
- x-create-product
- model
- sonnet
- description
- Transform an ideation file into a Product artifact with RNF roots and C1 capability stub.
- allowed-tools
- Read, Write, Bash
- argument-hint
- --ideation-file <PATH> [--output-dir <PATH>] [--product-id <ID>] [--dry-run]
- context-budget
- light
- user-invocable
- true
- requires-capabilities
- []
03 SKILL.md 正文
Output Policy
- Language: Portuguese (pt-BR) for content. English for technical terms and code identifiers.
- Tone: Technical, Direct, and Concise.
Skill: x-create-product
Purpose
Transform a validated ideation artifact (_TEMPLATE-IDEATION.md) into a Product artifact (_PRODUCT.md) with 8 sections, Root RNFs inherited from the ideation, and a stub for the first Capability (C1). This is the entry point of the Product-First Lifecycle hierarchy: Ideation → Product → Capability → Feature → Epic → Story → Task.
Execution is idempotent: re-running with the same --product-id regenerates the same product without creating duplicates.
When to Use
- After
x-ideate-featureproduces and validates a transient ideation - When converting a persistent ideation (
ai/ideations/ideation-NNNN.md) into a Product - First step before
x-create-capability
CLI Command
ia-dev-env x-create-product --ideation-file ai/ideations/ideation-0001.md
ia-dev-env x-create-product --ideation-file ai/ideations/ideation-0001.md --product-id product-0002
ia-dev-env x-create-product --ideation-file ai/ideations/ideation-0001.md --dry-run
Triggers
/x-create-product --ideation-file <PATH>/x-create-product --ideation-file <PATH> --dry-run— validate without writing files
Arguments
| Flag | Required | Description |
|---|---|---|
--ideation-file |
yes | Path to the ideation markdown file |
--product-id |
no | Override product identifier (e.g. product-0002). Default: auto-numbered |
--output-dir |
no | Output directory (default: ai/products/) |
--dry-run |
no | Validate inputs without writing files |
Output
Produces:
ai/products/product-NNNN.md— Product artifact with 8 sections + RNF Root table + C1 stub- Console summary with product-id, RNF count, and C1 stub path
Exit Codes
| Code | Meaning |
|---|---|
| 0 | Success |
| 1 | Validation error (invalid ideation format, pattern mismatch) |
| 2 | Execution error (I/O failure) |
Examples
# Create product from ideation
ia-dev-env x-create-product --ideation-file ai/ideations/ideation-0001.md
# Dry-run — validate only
ia-dev-env x-create-product --ideation-file ai/ideations/ideation-0001.md --dry-run
# Explicit product id
ia-dev-env x-create-product --ideation-file ai/ideations/ideation-0001.md --product-id product-0003
Related Skills
| Skill | Relationship |
|---|---|
x-ideate-feature |
Produces the ideation input consumed by this skill |
x-promote-ideation |
Promotes transient ideation to persistent before this skill runs |
x-create-capability |
Next step — decomposes this product into capabilities |
References
04 同仓库更多 Skills
x-parallel-eval
Detects and classifies file-collision risks between work units (tasks, stories, or epic phases) before parallel execution. Reads ## File Footprint blocks produced by x-task-plan / x-story-plan, applies the parallelism-heuristics knowledge pack (hard / regen / soft categories + hotspot overrides), and emits a collision matrix + serialization recommendation in Markdown (default) or JSON.
parallelism-heuristics
Canonical catalog of file-collision heuristics for parallel task, story, and epic execution. Defines the File Footprint block format, the three Conflict Categories (hard / regen / soft), a hotspot list of high-contention paths, and the degrade-with-warning policy. Consumed by x-task-plan, x-story-plan, x-epic-map, x-parallel-eval, and x-dev-*-implement.
x-watch-pr-ci
Polls a PR's CI checks and Copilot review status, blocking until checks complete or timeout. Returns one of 8 stable exit codes (SUCCESS=0, CI_PENDING_PROCEED=10, CI_FAILED=20, TIMEOUT=30, PR_ALREADY_MERGED=40, NO_CI_CONFIGURED=50, PR_CLOSED=60, PR_NOT_FOUND=70). Writes a versioned state-file for session resume.
x-validate-docs
Documentation freshness gate: validates 6 dimensions (readme, api-specs, grpc-proto, adr, skill-docs, system-architecture) against code changes in a PR. Stack-aware — only validates targets declared/auto-detected from ProjectConfig.documentation.targets. Returns exit non-zero on staleness; produces structured report.
x-update-system-architecture
Incrementally updates docs/architecture/system.md after an epic completes. Appends new entries to the Decision Log (§11) using x-internal-write-report --append (dedup by ## ID: marker) and surgically inserts component/integration changes into sections 1-10 via Edit. Idempotent: re-running with the same epic produces a byte-identical system.md.
x-update-architecture
Incrementally updates the service architecture document with changes from architecture plans. Adds new components, integrations, flows, and ADR references without rewriting existing content. Use after implementation to keep architecture documentation current.