[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M73C8VC6M3JC88C1H72Z0VX8":3,"skill-same:01M73C8VC6M3JC88C1H72Z0VX8":61},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":15,"categories":16,"keywords":17,"publishedAt":18,"linkOnly":19,"markdownContent":20,"markdownBody":21,"frontMatter":22,"refName":39,"commitSha":40,"skillDirectory":41,"forksCount":42,"repositoryHtmlUrl":43,"repositoryHomepageUrl":6,"ownerHtmlUrl":44,"ownerBlogUrl":6,"ownerDescription":45,"updatedAt":46,"install":47,"resources":60},"01M73C8VC6M3JC88C1H72Z0VX8","project-to-variant",null,"Convert an existing standalone project into an official variant template. Use when: a proven project should become a reusable template for future projects.","5throck\u002Fai-workspace-standards","5throck","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F10958964?v=4","01M73BFEH0V0VS483TW4JD49JW","01M73BFEJ5VQZJHJSFTVPAZGDM",25,"AGPL-3.0","https:\u002F\u002Fgithub.com\u002F5throck\u002Fai-workspace-standards\u002Fblob\u002Fmain\u002F.hermes\u002Fskills\u002Fproject-to-variant\u002FSKILL.md",[],[],"2026-11-11 15:11:14",false,"---\nname: project-to-variant\ndescription: \"Convert an existing standalone project into an official variant template. Use when: a proven project should become a reusable template for future projects.\"\nversion: 1.3.0\nstatus: active\nscope: workspace\nowner: scaffolding-expert\nlast_reviewed: 2026-11-08\nrelates_to:\n  - skill: promote-variant\n    type: composes_with\nmetadata:\n  type: scaffolding\n  triggers:\n    - convert project to variant\n    - create variant from project\n    - project to template\n    - promote project to variant\n---\n\n# Project to Variant\n\nConverts an existing standalone project into an official `co-*` variant template.\n\n## When to Use\n\n- An existing project has proven domain-specific patterns worth reusing\n- 3+ custom agents or 2+ custom skills have been developed\n- The project is expected to spawn 3+ future projects\n- The project has been tested in 2+ engagements and is stable\n\n## Script\n\n**Script**: `scripts\u002Fproject-to-variant.ts`\n**Usage**: `bun scripts\u002Fproject-to-variant.ts --source \u003Cproject-path> --target \u003Cvariant-name> [--dry-run] [--force] [--design-doc \u003Cpath>] [--threshold-files \u003Cn>] [--threshold-dirs \u003Cn>]`\n\n### Arguments\n\n| Argument | Required | Description |\n|----------|----------|-------------|\n| `--source \u003Cpath>` | Yes | Path to the existing project (e.g., `Projects\u002Fco-legal`) |\n| `--target \u003Cname>` | Yes | Variant name, must match `^co-[a-z][a-z0-9-]{1,30}$` (e.g., `co-legal`) |\n| `--dry-run` | No | Preview without writing files |\n| `--force` | No | Proceed even if the complexity routing check recommends the Full L2 Pipeline instead |\n| `--design-doc \u003Cpath>` | No | Auto-register this spec via `spec-register.ts` (can't be auto-discovered) |\n| `--threshold-files \u003Cn>` | No | Override the variant-unique-file-count routing threshold (default 40) |\n| `--threshold-dirs \u003Cn>` | No | Override the large-domain-dir-count routing threshold (default 3) |\n\n## What It Does\n\n1. Diffs the project against `templates\u002Fcommon\u002F`\n2. Keeps only variant-unique files\n3. Skips `.git\u002F`, `node_modules\u002F`, `memory\u002F`\n4. **Complexity routing check**: if the project diverges significantly from `templates\u002Fcommon\u002F` (more than `--threshold-files` variant-unique files, or more than `--threshold-dirs` domain directories with >15 files each that don't exist in `templates\u002Fcommon\u002F`), it prints a recommendation to use the Full L2 Pipeline instead and aborts unless `--force` is passed — this automates the judgment call that used to live only in this doc's prose (see Alternative below)\n5. Generates `variant.json` if not present\n6. Runs `validate-templates.ts` for verification\n7. Regenerates `templates\u002F\u003Ctarget>\u002FAGENTS.md` via `regenerate-agents-md.ts` (mechanical — always run, not gated on judgment)\n8. Registers the spec via `spec-register.ts` if `--design-doc` was passed\n9. Outputs a manual review checklist for the remaining judgment-based items only (`pm.md` override review, `CLAUDE.md`\u002F`GEMINI.md` narrative context, country-profile review items)\n\n### Country Profiles and Country-Scoped Skills\n\nWhen the source project carries country assets, the conversion handles them as follows:\n\n- `docs\u002Fcountries\u002FACTIVE.md` is **excluded** - it records this project's country selection (project state), not reusable template knowledge\n- `docs\u002Fcountries\u002F\u003CCODE>.md` profiles **are carried** into the template - they are durable jurisdiction knowledge (statutes, regulators, formats)\n- The `country_config` key in `variant.json` is **preserved**, keeping `supported` in sync with the carried profiles\n- Country-scoped skills (all six `k-*` skills - see the `country_scoped_assets` registry in `docs\u002Fworkspace-schema.json`) are **never copied** into the variant: they already live in `templates\u002Fcommon\u002Fskills\u002F` and deploy only to matching-country projects at scaffold time\n\nWhen reviewing the output, confirm `country_config.supported` matches exactly the profiles carried into `templates\u002F\u003Ctarget>\u002Fdocs\u002Fcountries\u002F`. The full L2 pipeline (`l3-to-variant-pipeline.ts`) applies the same rules. See ADR-0057 for the full mechanism.\n\n## Step-by-Step Procedure\n\n1. **Evaluate suitability**: ≥3 domain agents, ≥2 skills, ≥3 expected future projects\n2. **Prepare**: Remove `node_modules\u002F`, `.env`, `memory\u002F`, `CHANGELOG.md`\n3. **Run conversion**: `bun scripts\u002Fproject-to-variant.ts --source \u003Cproject-path> --target \u003Cvariant-name> --design-doc \u003Cpath-to-design-doc>`\n4. **Verify**: `bun scripts\u002Fvalidate-templates.ts`\n5. **Review variant.json**: Check agents, skills, script_manifest, and `country_config` (if country profiles were carried)\n6. **Complete the printed manual checklist**: `pm.md` overrides and `CLAUDE.md`\u002F`GEMINI.md` narrative context — everything else is now automated\n\n## Alternative: Full L2 Pipeline\n\nThe script itself recommends this automatically when the complexity routing check trips (see step 4 above). For a more thorough conversion with ADR-referenced review, anti-swelling checks, and platform-parity enforcement:\n\n```bash\ncp -r \u003Cproject-path> Projects\u002F\u003Cvariant-name>\u002F\ncd Projects\u002F\u003Cvariant-name>\u002F && git init && git add -A && git commit -m \"initial\"\ncd \u003Cworkspace-root>\nbun scripts\u002Fl3-to-variant-pipeline.ts --l3-path Projects\u002F\u003Cvariant-name>\u002F --name \u003Cvariant-name> --type \u003Ccollaboration|consulting|lecture> --description \"\u003Cone-line description>\" --auto-fix-agents-md --auto-fix-pm-md\n```\n\nSince `l3-to-variant-pipeline.ts` v1.21.2, `--auto-fix-agents-md` \u002F `--auto-fix-pm-md` let the pipeline regenerate the variant `AGENTS.md` from the L3 roster, and `generate-variant.ts` ≥ 1.12.0 materializes domain skills into all three skill roots, preserves agent `lifecycle` frontmatter, and re-applies VARIANT-INJECT markers — the manual post-run fixes this path used to require are automated.\n\n## See Also\n\n- [Variant Creation Skill](..\u002Fcreate-variant\u002FSKILL.md)\n- [Variant Promotion Skill](..\u002Fpromote-variant\u002FSKILL.md)\n- [Variant Conversion Guide](..\u002F..\u002Fdocs\u002Fguides\u002Fvariant-conversion-guide.md)\n- [Variant Review Report (2026-07-14)](..\u002F..\u002Fdocs\u002Freports\u002Fvariant-review-report-2026-07-14.md)\n","# Project to Variant\n\nConverts an existing standalone project into an official `co-*` variant template.\n\n## When to Use\n\n- An existing project has proven domain-specific patterns worth reusing\n- 3+ custom agents or 2+ custom skills have been developed\n- The project is expected to spawn 3+ future projects\n- The project has been tested in 2+ engagements and is stable\n\n## Script\n\n**Script**: `scripts\u002Fproject-to-variant.ts`\n**Usage**: `bun scripts\u002Fproject-to-variant.ts --source \u003Cproject-path> --target \u003Cvariant-name> [--dry-run] [--force] [--design-doc \u003Cpath>] [--threshold-files \u003Cn>] [--threshold-dirs \u003Cn>]`\n\n### Arguments\n\n| Argument | Required | Description |\n|----------|----------|-------------|\n| `--source \u003Cpath>` | Yes | Path to the existing project (e.g., `Projects\u002Fco-legal`) |\n| `--target \u003Cname>` | Yes | Variant name, must match `^co-[a-z][a-z0-9-]{1,30}$` (e.g., `co-legal`) |\n| `--dry-run` | No | Preview without writing files |\n| `--force` | No | Proceed even if the complexity routing check recommends the Full L2 Pipeline instead |\n| `--design-doc \u003Cpath>` | No | Auto-register this spec via `spec-register.ts` (can't be auto-discovered) |\n| `--threshold-files \u003Cn>` | No | Override the variant-unique-file-count routing threshold (default 40) |\n| `--threshold-dirs \u003Cn>` | No | Override the large-domain-dir-count routing threshold (default 3) |\n\n## What It Does\n\n1. Diffs the project against `templates\u002Fcommon\u002F`\n2. Keeps only variant-unique files\n3. Skips `.git\u002F`, `node_modules\u002F`, `memory\u002F`\n4. **Complexity routing check**: if the project diverges significantly from `templates\u002Fcommon\u002F` (more than `--threshold-files` variant-unique files, or more than `--threshold-dirs` domain directories with >15 files each that don't exist in `templates\u002Fcommon\u002F`), it prints a recommendation to use the Full L2 Pipeline instead and aborts unless `--force` is passed — this automates the judgment call that used to live only in this doc's prose (see Alternative below)\n5. Generates `variant.json` if not present\n6. Runs `validate-templates.ts` for verification\n7. Regenerates `templates\u002F\u003Ctarget>\u002FAGENTS.md` via `regenerate-agents-md.ts` (mechanical — always run, not gated on judgment)\n8. Registers the spec via `spec-register.ts` if `--design-doc` was passed\n9. Outputs a manual review checklist for the remaining judgment-based items only (`pm.md` override review, `CLAUDE.md`\u002F`GEMINI.md` narrative context, country-profile review items)\n\n### Country Profiles and Country-Scoped Skills\n\nWhen the source project carries country assets, the conversion handles them as follows:\n\n- `docs\u002Fcountries\u002FACTIVE.md` is **excluded** - it records this project's country selection (project state), not reusable template knowledge\n- `docs\u002Fcountries\u002F\u003CCODE>.md` profiles **are carried** into the template - they are durable jurisdiction knowledge (statutes, regulators, formats)\n- The `country_config` key in `variant.json` is **preserved**, keeping `supported` in sync with the carried profiles\n- Country-scoped skills (all six `k-*` skills - see the `country_scoped_assets` registry in `docs\u002Fworkspace-schema.json`) are **never copied** into the variant: they already live in `templates\u002Fcommon\u002Fskills\u002F` and deploy only to matching-country projects at scaffold time\n\nWhen reviewing the output, confirm `country_config.supported` matches exactly the profiles carried into `templates\u002F\u003Ctarget>\u002Fdocs\u002Fcountries\u002F`. The full L2 pipeline (`l3-to-variant-pipeline.ts`) applies the same rules. See ADR-0057 for the full mechanism.\n\n## Step-by-Step Procedure\n\n1. **Evaluate suitability**: ≥3 domain agents, ≥2 skills, ≥3 expected future projects\n2. **Prepare**: Remove `node_modules\u002F`, `.env`, `memory\u002F`, `CHANGELOG.md`\n3. **Run conversion**: `bun scripts\u002Fproject-to-variant.ts --source \u003Cproject-path> --target \u003Cvariant-name> --design-doc \u003Cpath-to-design-doc>`\n4. **Verify**: `bun scripts\u002Fvalidate-templates.ts`\n5. **Review variant.json**: Check agents, skills, script_manifest, and `country_config` (if country profiles were carried)\n6. **Complete the printed manual checklist**: `pm.md` overrides and `CLAUDE.md`\u002F`GEMINI.md` narrative context — everything else is now automated\n\n## Alternative: Full L2 Pipeline\n\nThe script itself recommends this automatically when the complexity routing check trips (see step 4 above). For a more thorough conversion with ADR-referenced review, anti-swelling checks, and platform-parity enforcement:\n\n```bash\ncp -r \u003Cproject-path> Projects\u002F\u003Cvariant-name>\u002F\ncd Projects\u002F\u003Cvariant-name>\u002F && git init && git add -A && git commit -m \"initial\"\ncd \u003Cworkspace-root>\nbun scripts\u002Fl3-to-variant-pipeline.ts --l3-path Projects\u002F\u003Cvariant-name>\u002F --name \u003Cvariant-name> --type \u003Ccollaboration|consulting|lecture> --description \"\u003Cone-line description>\" --auto-fix-agents-md --auto-fix-pm-md\n```\n\nSince `l3-to-variant-pipeline.ts` v1.21.2, `--auto-fix-agents-md` \u002F `--auto-fix-pm-md` let the pipeline regenerate the variant `AGENTS.md` from the L3 roster, and `generate-variant.ts` ≥ 1.12.0 materializes domain skills into all three skill roots, preserves agent `lifecycle` frontmatter, and re-applies VARIANT-INJECT markers — the manual post-run fixes this path used to require are automated.\n\n## See Also\n\n- [Variant Creation Skill](..\u002Fcreate-variant\u002FSKILL.md)\n- [Variant Promotion Skill](..\u002Fpromote-variant\u002FSKILL.md)\n- [Variant Conversion Guide](..\u002F..\u002Fdocs\u002Fguides\u002Fvariant-conversion-guide.md)\n- [Variant Review Report (2026-07-14)](..\u002F..\u002Fdocs\u002Freports\u002Fvariant-review-report-2026-07-14.md)\n",{"name":5,"owner":23,"scope":24,"status":25,"version":26,"metadata":27,"relates_to":34,"description":7,"last_reviewed":38},"scaffolding-expert","workspace","active","1.3.0",{"type":28,"triggers":29},"scaffolding",[30,31,32,33],"convert project to variant","create variant from project","project to template","promote project to variant",[35],{"type":36,"skill":37},"composes_with","promote-variant",1794096000000,"main","1162ccc568cf90c01b3886d6143cbfd851a37883",".hermes\u002Fskills\u002Fproject-to-variant",9,"https:\u002F\u002Fgithub.com\u002F5throck\u002Fai-workspace-standards","https:\u002F\u002Fgithub.com\u002F5throck","Experienced in digital transformation, enterprise IT, startup acceleration, and business strategy. Focused on building practical systems that connect technolo","2026-11-14 21:22:34",{"source":8,"skillName":5,"commands":48,"prompt":58,"zipAvailable":59},[49,52,55],{"tool":50,"command":51},"npx","npx skills add 5throck\u002Fai-workspace-standards --skill project-to-variant",{"tool":53,"command":54},"bunx","bunx skills add 5throck\u002Fai-workspace-standards --skill project-to-variant",{"tool":56,"command":57},"pnpm","pnpm dlx skills add 5throck\u002Fai-workspace-standards --skill project-to-variant","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002F5throck\u002Fai-workspace-standards\u002Fblob\u002Fmain\u002F.hermes\u002Fskills\u002Fproject-to-variant\u002FSKILL.md",true,[],[62,70,75,80,85,90],{"skillNo":63,"name":64,"nameZh":6,"description":65,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":66,"categories":67,"keywords":68,"publishedAt":69},"01M7BBJDYHJMGTJYSC37JVWY8S","i18n-layout","Text layout and encoding guidance: character encoding (UTF-8, legacy Korean code pages, BOM hazards), line endings, RTL\u002Fbidi handling, and script-specific font selection (Hangul focus). Use when: encoding is corrupted or mojibake appears, an RTL locale must render correctly, fonts must be chosen for a script, or CRLF\u002FBOM issues surface.","https:\u002F\u002Fgithub.com\u002F5throck\u002Fai-workspace-standards\u002Fblob\u002Fmain\u002Ftemplates\u002Fco-work\u002Fskills\u002Fi18n-layout\u002FSKILL.md",[],[],"2026-11-15 14:19:17",{"skillNo":71,"name":64,"nameZh":6,"description":65,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":72,"categories":73,"keywords":74,"publishedAt":69},"01M7BBJ9XHAAS1AVGKZZ841VBZ","https:\u002F\u002Fgithub.com\u002F5throck\u002Fai-workspace-standards\u002Fblob\u002Fmain\u002Ftemplates\u002Fco-work\u002F.hermes\u002Fskills\u002Fi18n-layout\u002FSKILL.md",[],[],{"skillNo":76,"name":64,"nameZh":6,"description":65,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":77,"categories":78,"keywords":79,"publishedAt":69},"01M7BBJ5C3X8TKFKG5R9P9P49W","https:\u002F\u002Fgithub.com\u002F5throck\u002Fai-workspace-standards\u002Fblob\u002Fmain\u002Ftemplates\u002Fco-work\u002F.gemini\u002Fskills\u002Fi18n-layout\u002FSKILL.md",[],[],{"skillNo":81,"name":64,"nameZh":6,"description":65,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":82,"categories":83,"keywords":84,"publishedAt":69},"01M7BBJ1B52X0QMJ2QVBMPJB37","https:\u002F\u002Fgithub.com\u002F5throck\u002Fai-workspace-standards\u002Fblob\u002Fmain\u002Ftemplates\u002Fco-work\u002F.codex\u002Fskills\u002Fi18n-layout\u002FSKILL.md",[],[],{"skillNo":86,"name":64,"nameZh":6,"description":65,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":87,"categories":88,"keywords":89,"publishedAt":69},"01M7BBHX91BW2Q2R276MRX5AW3","https:\u002F\u002Fgithub.com\u002F5throck\u002Fai-workspace-standards\u002Fblob\u002Fmain\u002Ftemplates\u002Fco-work\u002F.claude\u002Fskills\u002Fi18n-layout\u002FSKILL.md",[],[],{"skillNo":91,"name":64,"nameZh":6,"description":65,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":92,"categories":93,"keywords":94,"publishedAt":69},"01M7BBHQWGXPSFRWN1PRC2NMMV","https:\u002F\u002Fgithub.com\u002F5throck\u002Fai-workspace-standards\u002Fblob\u002Fmain\u002Ftemplates\u002Fco-work\u002F.agents\u002Fskills\u002Fi18n-layout\u002FSKILL.md",[],[]]