Platform Project Skill

Route

| Target | Workflow | |---|---| | Empty or new | references/workflow-new-project.md | | Existing production code | references/workflow-existing-project.md + references/non-invasive-upgrade.md | | Copied public repository | references/workflow-open-source-fork.md | | README, assets, or graphify only | references/INDEX.md |

When a path is provided, run scripts/inspect-project.sh <path> before choosing a route.

Hard Constraints

• Derive new projects only through scripts/create-platform-project.sh; never reconstruct the bundled template from memory.
• Existing-project upgrades are inspect-first, conservative, .gitignore-aware, and must not change business code or structure by default.
• Keep Codebase Memory project-local and opt-in. Never download its binary, register a global MCP, start watchers, or index automatically during initialization.
• Generate eight baseline Skills plus deterministic UI Profiles. Keep Handoff project-local, exclude Headroom, keep Ant Design/GSAP dependencies opt-in, and never install upstream provider hooks.
• Generate the five root cognition image types in equivalent zh-CN and en copies with image_gen, then register them. Treat front/mobile/server UI and module images as optional until the owning subproject needs them.
• Prefer shared PostgreSQL and Redis. Use standalone containers only when shared infrastructure is unavailable or isolation is explicit.
• README images use direct Markdown; social preview PNG must remain below 1 MiB.
• Public publishing, repository metadata, commits, tags, pushes, and releases require explicit approval.

Completion Gate

For new projects, advance only in this order:

text
scaffold_done -> agent_ready_done -> asset_done -> visual_acceptance_done -> validation_done -> initialization_done

Run the generated project's Agent Skill verifier with --baseline, generate and register all required images, record per-image human acceptance, then run:

bash
scripts/validate-platform-project.sh <project-path>

Only that total validator may emit STATE=validation_done. Any failed state or unfinished asset requires a partial/blocking report, not "complete". Use references/completion-report-template.md for the final report.

Load additional rules only through references/INDEX.md as the selected route needs them.