Prodcraft
Use Prodcraft as the software-development entry system for this machine.
Entry Rule
For new, unclear, or cross-phase software-development work:
- Start with
pc-intake
- If the route is clear but the problem direction is still fuzzy, continue with
pc-problem-framing
- Use the portable routing map to select downstream skills and that generated routing map to pick the workflow
For clearly tactical software-development work, route quickly but keep the lifecycle decision observable instead of silently bypassing Prodcraft.
Priority
- Treat Prodcraft as the default entry system for software-development tasks, even when the user did not explicitly name Prodcraft.
- Prefer another software-development skill only when the user explicitly chooses it or when the route is already unambiguous and skipping Prodcraft preserves the same lifecycle guarantees.
- Treat most deeper lifecycle skills as routed by intake, workflow choice, or explicit handoff rather than as metadata-first auto-discovery targets.
- Keep obeying higher-priority system, developer, and repository instructions.
- For non-software-development tasks, use other relevant skills instead of forcing Prodcraft.
Routed Invocation
The curated install surface is a stable packaging contract, not a promise that every included skill should auto-trigger from metadata alone in a crowded local environment.
- entry and control-plane skills may need strong discoverability
- deeper lifecycle skills usually add value after route selection, not before it
- prefer routed handoff over forcing generic auto-discovery for architecture, planning, quality, and operations skills
Runtime Resolution
A pc-prodcraft directory that contains only this SKILL.md is a valid gateway install. It is not evidence that downstream Prodcraft skills are missing. Do not search for downstream skills inside the pc-prodcraft directory.
Resolve the actual operating context in this order:
- For a global install, read
prodcraft-runtime.json beside this file when it exists, then use its gateway_path, source_skills_root, workflow_root, and canonical_repo_root fields.
- In global mode, trust the current workspace as the source repository only when it is the locator's
canonical_repo_root or inside that root, and it also contains Prodcraft identity files such as CLAUDE.md, manifest.yml, skills/_gateway.md, schemas/distribution/public-skill-registry.json, and scripts/validate_prodcraft.py.
- Without a trusted global locator, treat a source repository as authoritative only when the user or higher-priority runtime context explicitly identifies it as the Prodcraft source repository and the same identity files are present.
- Look for sibling skill packages beside
pc-prodcraft, such as ../pc-intake/SKILL.md, ../pc-code-review/SKILL.md, ../pc-testing-strategy/SKILL.md, and ../pc-security-audit/SKILL.md. Sibling packages provide public skill guidance; they do not provide source-repository authority.
- If neither a trusted source repository nor sibling public skill packages can be resolved, treat the runtime as a partial entry install.
Use explicit file reads for these checks. Do not recursively search arbitrary parent directories or run shell commands to discover a substitute repository.
In partial-entry mode, keep the boundary explicit:
- say:
This is partial-entry guidance, not a completed Prodcraft workflow or evidence gate.
- produce only an entry-level route recommendation and name the missing runtime context
- if the quality target context is missing, ask for
runtime_context, exposure_profile, production_target, non_targets, and evidence_refs
- do not assume public HTTP service from framework names, routes, CORS, HTTP clients, or model provider adapters
- ask for the source repository path or installation of the needed public skill package before deeper execution
- do not claim that downstream skills such as
pc-code-review, pc-testing-strategy, or pc-security-audit ran
- do not manually simulate repository validators, workflow approval, QA evidence, or completion gates as if Prodcraft executed them
Observability
When Prodcraft is chosen, preserve routing observability:
- why Prodcraft was invoked
- which entry skill was chosen
- what next skill or workflow was selected
- which source repository, runtime locator, or sibling skill package was used
- whether any global skill override experiment is active
Distribution
- Install surface:
curated
- Packaging stability:
beta
- Capability readiness:
core
- Canonical repo source: see the generated routing map provenance
- Gateway contract: the portable routing map
- No machine-specific locator is bundled with the curated package; if the source repository is not available, rely only on sibling public skill packages that are actually installed.
- Portability:
portable_with_caveat
- Public caveat: Portable as skill guidance; full governance guarantees require the Prodcraft repository contracts and validation checks.
1---2name: pc-prodcraft3description: Use when software-development work is underway or likely, so the task routes through the Prodcraft lifecycle-aware entry stack before planning, implementation, quality gates, or workflow selection. Default to Prodcraft for software-development unless the user explicitly chooses another path.4---56# Prodcraft78Use Prodcraft as the software-development entry system for this machine.910## Entry Rule1112For new, unclear, or cross-phase software-development work:13141. Start with `pc-intake`152. If the route is clear but the problem direction is still fuzzy, continue with `pc-problem-framing`163. Use the [portable routing map](references/routing-map.md) to select downstream skills and that generated routing map to pick the workflow1718For clearly tactical software-development work, route quickly but keep the lifecycle decision observable instead of silently bypassing Prodcraft.1920## Priority2122- Treat Prodcraft as the default entry system for software-development tasks, even when the user did not explicitly name Prodcraft.23- Prefer another software-development skill only when the user explicitly chooses it or when the route is already unambiguous and skipping Prodcraft preserves the same lifecycle guarantees.24- Treat most deeper lifecycle skills as **routed** by intake, workflow choice, or explicit handoff rather than as metadata-first auto-discovery targets.25- Keep obeying higher-priority system, developer, and repository instructions.26- For non-software-development tasks, use other relevant skills instead of forcing Prodcraft.2728## Routed Invocation2930The curated install surface is a stable packaging contract, not a promise that every included skill should auto-trigger from metadata alone in a crowded local environment.3132- entry and control-plane skills may need strong discoverability33- deeper lifecycle skills usually add value after route selection, not before it34- prefer routed handoff over forcing generic auto-discovery for architecture, planning, quality, and operations skills3536## Runtime Resolution3738A `pc-prodcraft` directory that contains only this `SKILL.md` is a valid gateway install. It is not evidence that downstream Prodcraft skills are missing. Do not search for downstream skills inside the `pc-prodcraft` directory.3940Resolve the actual operating context in this order:41421. For a global install, read `prodcraft-runtime.json` beside this file when it exists, then use its `gateway_path`, `source_skills_root`, `workflow_root`, and `canonical_repo_root` fields.432. In global mode, trust the current workspace as the source repository only when it is the locator's `canonical_repo_root` or inside that root, and it also contains Prodcraft identity files such as `CLAUDE.md`, `manifest.yml`, `skills/_gateway.md`, `schemas/distribution/public-skill-registry.json`, and `scripts/validate_prodcraft.py`.443. Without a trusted global locator, treat a source repository as authoritative only when the user or higher-priority runtime context explicitly identifies it as the Prodcraft source repository and the same identity files are present.454. Look for sibling skill packages beside `pc-prodcraft`, such as `../pc-intake/SKILL.md`, `../pc-code-review/SKILL.md`, `../pc-testing-strategy/SKILL.md`, and `../pc-security-audit/SKILL.md`. Sibling packages provide public skill guidance; they do not provide source-repository authority.465. If neither a trusted source repository nor sibling public skill packages can be resolved, treat the runtime as a partial entry install.4748Use explicit file reads for these checks. Do not recursively search arbitrary parent directories or run shell commands to discover a substitute repository.4950In partial-entry mode, keep the boundary explicit:5152- say: `This is partial-entry guidance, not a completed Prodcraft workflow or evidence gate.`53- produce only an entry-level route recommendation and name the missing runtime context54- if the quality target context is missing, ask for `runtime_context`, `exposure_profile`, `production_target`, `non_targets`, and `evidence_refs`55- do not assume public HTTP service from framework names, routes, CORS, HTTP clients, or model provider adapters56- ask for the source repository path or installation of the needed public skill package before deeper execution57- do not claim that downstream skills such as `pc-code-review`, `pc-testing-strategy`, or `pc-security-audit` ran58- do not manually simulate repository validators, workflow approval, QA evidence, or completion gates as if Prodcraft executed them5960## Observability6162When Prodcraft is chosen, preserve routing observability:6364- why Prodcraft was invoked65- which entry skill was chosen66- what next skill or workflow was selected67- which source repository, runtime locator, or sibling skill package was used68- whether any global skill override experiment is active6970## Distribution7172- Install surface: `curated`73- Packaging stability: `beta`74- Capability readiness: `core`75- Canonical repo source: see the generated routing map provenance76- Gateway contract: the [portable routing map](references/routing-map.md)77- No machine-specific locator is bundled with the curated package; if the source repository is not available, rely only on sibling public skill packages that are actually installed.78- Portability: `portable_with_caveat`79- Public caveat: Portable as skill guidance; full governance guarantees require the Prodcraft repository contracts and validation checks.