[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M6DAQBMHZYFNHS2KGS6XJHT8":3,"skill-same:01M6DAQBMHZYFNHS2KGS6XJHT8":62},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":15,"categories":16,"keywords":17,"publishedAt":27,"linkOnly":28,"markdownContent":29,"markdownBody":30,"frontMatter":31,"refName":32,"commitSha":33,"skillDirectory":34,"forksCount":13,"repositoryHtmlUrl":35,"repositoryHomepageUrl":6,"ownerHtmlUrl":36,"ownerBlogUrl":6,"ownerDescription":6,"updatedAt":37,"install":38,"resources":51},"01M6DAQBMHZYFNHS2KGS6XJHT8","software-architecture-documentation",null,"This skill should be used when creating, reviewing, or updating architecture documentation (ARCHITECTURE.md) for a software project. It provides a comprehensive template and best practices for producing documentation that enables rapid codebase comprehension by developers and AI agents.","tzeusy-org\u002Fai-bootstrap","tzeusy-org","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F141543652?v=4","01M6DAM1AP09H27BYGFY9QCNPB","01M6DAM1F4R187EK11XDN9JZKH",0,"MIT","https:\u002F\u002Fgithub.com\u002Ftzeusy-org\u002Fai-bootstrap\u002Fblob\u002Fmain\u002Fskills\u002Farchive\u002Fsoftware-architecture-documentation\u002FSKILL.md",[],[18,19,20,21,22,23,24,25,26],"architecture","documentation","software architecture","software","software architecture documentation","ai agents","best practices","template","project","2026-11-10 10:12:30",false,"---\nname: software-architecture-documentation\ndescription: This skill should be used when creating, reviewing, or updating architecture documentation (ARCHITECTURE.md) for a software project. It provides a comprehensive template and best practices for producing documentation that enables rapid codebase comprehension by developers and AI agents.\n---\n\n# Software Architecture Documentation\n\nGenerate comprehensive ARCHITECTURE.md files that enable developers and AI agents to rapidly understand a codebase. Based on the [architecture.md](https:\u002F\u002Farchitecture.md\u002F) template by [timajwilliams](https:\u002F\u002Fgithub.com\u002Ftimajwilliams\u002Farchitecture).\n\n## When To Use\n\n- A new project needs architecture documentation\n- Onboarding documentation is missing or outdated\n- A codebase is being prepared for AI agent interaction\n- Existing architecture docs need review or improvement\n- Documentation completeness audit is requested\n\n## Workflow\n\n### Creating New Architecture Docs\n\n1. **Explore the codebase** - Run `tree -L 3 -I 'node_modules|__pycache__|.git|dist|build'` to understand directory structure\n2. **Identify technologies** - Check package.json, requirements.txt, go.mod, Cargo.toml, or similar dependency files\n3. **Trace data flow** - Follow entry points (routes, handlers) through to storage\n4. **Map external dependencies** - Review configs and environment variables for third-party services\n5. **Load the template** - Read `references\u002Farchitecture-template.md` and fill in each section\n6. **Verify accuracy** - Cross-reference documented structure against actual code\n\n### Reviewing Existing Docs\n\n1. **Compare against template** - Read `references\u002Farchitecture-template.md` to identify missing sections\n2. **Verify currency** - Check if documented structure matches actual codebase\n3. **Test comprehension** - Determine if someone can navigate the codebase using only the doc\n4. **Update stale sections** - Prioritize project structure and external integrations\n\n## Output Location\n\nPlace the generated documentation at `ARCHITECTURE.md` in the repository root, or `docs\u002FARCHITECTURE.md` if documentation is centralized.\n\n## Key Principles\n\n1. **Optimize for speed** - Enable rapid comprehension, not exhaustive coverage\n2. **Stay current** - Outdated docs are worse than no docs\n3. **Be honest** - Document what exists, not what is wished for\n4. **Link, don't duplicate** - Reference code files instead of copying content\n5. **Use portable diagrams** - ASCII art or Mermaid for version control friendliness\n\n## Resources\n\n- `references\u002Farchitecture-template.md` - The complete 11-section template to fill in\n- `references\u002Fwriting-guide.md` - Best practices, anti-patterns, and project-type-specific guidance\n","# Software Architecture Documentation\n\nGenerate comprehensive ARCHITECTURE.md files that enable developers and AI agents to rapidly understand a codebase. Based on the [architecture.md](https:\u002F\u002Farchitecture.md\u002F) template by [timajwilliams](https:\u002F\u002Fgithub.com\u002Ftimajwilliams\u002Farchitecture).\n\n## When To Use\n\n- A new project needs architecture documentation\n- Onboarding documentation is missing or outdated\n- A codebase is being prepared for AI agent interaction\n- Existing architecture docs need review or improvement\n- Documentation completeness audit is requested\n\n## Workflow\n\n### Creating New Architecture Docs\n\n1. **Explore the codebase** - Run `tree -L 3 -I 'node_modules|__pycache__|.git|dist|build'` to understand directory structure\n2. **Identify technologies** - Check package.json, requirements.txt, go.mod, Cargo.toml, or similar dependency files\n3. **Trace data flow** - Follow entry points (routes, handlers) through to storage\n4. **Map external dependencies** - Review configs and environment variables for third-party services\n5. **Load the template** - Read `references\u002Farchitecture-template.md` and fill in each section\n6. **Verify accuracy** - Cross-reference documented structure against actual code\n\n### Reviewing Existing Docs\n\n1. **Compare against template** - Read `references\u002Farchitecture-template.md` to identify missing sections\n2. **Verify currency** - Check if documented structure matches actual codebase\n3. **Test comprehension** - Determine if someone can navigate the codebase using only the doc\n4. **Update stale sections** - Prioritize project structure and external integrations\n\n## Output Location\n\nPlace the generated documentation at `ARCHITECTURE.md` in the repository root, or `docs\u002FARCHITECTURE.md` if documentation is centralized.\n\n## Key Principles\n\n1. **Optimize for speed** - Enable rapid comprehension, not exhaustive coverage\n2. **Stay current** - Outdated docs are worse than no docs\n3. **Be honest** - Document what exists, not what is wished for\n4. **Link, don't duplicate** - Reference code files instead of copying content\n5. **Use portable diagrams** - ASCII art or Mermaid for version control friendliness\n\n## Resources\n\n- `references\u002Farchitecture-template.md` - The complete 11-section template to fill in\n- `references\u002Fwriting-guide.md` - Best practices, anti-patterns, and project-type-specific guidance\n",{"name":5,"description":7},"main","c907d6f0bf96bd61b936e8972e0f1c66ebb8148c","skills\u002Farchive\u002Fsoftware-architecture-documentation","https:\u002F\u002Fgithub.com\u002Ftzeusy-org\u002Fai-bootstrap","https:\u002F\u002Fgithub.com\u002Ftzeusy-org","2026-11-10 23:17:25",{"source":8,"skillName":5,"commands":39,"prompt":49,"zipAvailable":50},[40,43,46],{"tool":41,"command":42},"npx","npx skills add tzeusy-org\u002Fai-bootstrap --skill software-architecture-documentation",{"tool":44,"command":45},"bunx","bunx skills add tzeusy-org\u002Fai-bootstrap --skill software-architecture-documentation",{"tool":47,"command":48},"pnpm","pnpm dlx skills add tzeusy-org\u002Fai-bootstrap --skill software-architecture-documentation","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Ftzeusy-org\u002Fai-bootstrap\u002Fblob\u002Fmain\u002Fskills\u002Farchive\u002Fsoftware-architecture-documentation\u002FSKILL.md",true,[52,58],{"path":53,"resourceType":54,"resourceTypeDesc":55,"sizeBytes":56,"sourceHtmlUrl":57},"references\u002Farchitecture-template.md","REFERENCE","参考文档",7284,"https:\u002F\u002Fgithub.com\u002Ftzeusy-org\u002Fai-bootstrap\u002Fblob\u002Fmain\u002Fskills\u002Farchive\u002Fsoftware-architecture-documentation\u002Freferences\u002Farchitecture-template.md",{"path":59,"resourceType":54,"resourceTypeDesc":55,"sizeBytes":60,"sourceHtmlUrl":61},"references\u002Fwriting-guide.md",4701,"https:\u002F\u002Fgithub.com\u002Ftzeusy-org\u002Fai-bootstrap\u002Fblob\u002Fmain\u002Fskills\u002Farchive\u002Fsoftware-architecture-documentation\u002Freferences\u002Fwriting-guide.md",[63,90,117,132,151,162],{"skillNo":64,"name":65,"nameZh":6,"description":66,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":67,"categories":68,"keywords":69,"publishedAt":27},"01M6DAZD21TWH2ET70V9FF75CQ","user-run","Use when a step needs privileges this session lacks (docker, sudo, another user's checkout or secrets, host access) and the owner must run it as tze. Writes a reviewable \u002Fhome\u002Forca\u002F.tmp\u002F\u003Cslug>\u002Frun.sh that impersonates tze (USER_TO_IMPERSONATE overrides), tees timestamped logs plus latest.log and collects artifacts there; Claude presents it with a risk and time brief, then continues from the logs. Triggers: \"I'll run it for you\", \"permission denied on docker.sock\", \"needs sudo\", \"sudo: a password is required\", \"run as tze\", \"\u002Fuser-run\".","https:\u002F\u002Fgithub.com\u002Ftzeusy-org\u002Fai-bootstrap\u002Fblob\u002Fmain\u002Fskills\u002Fpersonal\u002Fuser-run\u002FSKILL.md",[],[70,71,72,73,74,75,76,77,78,79,80,81,82,83,84,85,86,87,88,89],"user run","user","run","docker","logs","use","host","as","triggers","permission","active","time","log","artifacts","session","password","access","secrets","risk","brief",{"skillNo":91,"name":92,"nameZh":6,"description":93,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":94,"categories":95,"keywords":106,"publishedAt":27},"01M6DAZAHTCBAD2WF0GAHWPST8","requesting-code-review","Use when completing tasks, implementing major features, or before merging to verify work meets requirements","https:\u002F\u002Fgithub.com\u002Ftzeusy-org\u002Fai-bootstrap\u002Fblob\u002Fmain\u002Fskills\u002Fpersonal\u002Fth-workflow\u002Fsubskills\u002Frequesting-code-review\u002FSKILL.md",[96,101],{"categoryNo":97,"categoryName":98,"taxonomyType":99,"taxonomyTypeDesc":100},"01JBSEEDCAT000000000000007","代码审查","SCENARIO","使用场景",{"categoryNo":102,"categoryName":103,"taxonomyType":104,"taxonomyTypeDesc":105},"01JBSEEDCAT000000000000030","开发工程师","PROFESSION","适用职业",[107,108,109,110,111,112,80,113,114,75,115,116],"requesting code review","code","review","code review","work","requirements","upstream","superpowers","verify","tasks",{"skillNo":118,"name":119,"nameZh":6,"description":120,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":121,"categories":122,"keywords":125,"publishedAt":27},"01M6DAZ7CJ82D81XZB2YHVVY48","receiving-code-review","Use when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not performative agreement or blind implementation","https:\u002F\u002Fgithub.com\u002Ftzeusy-org\u002Fai-bootstrap\u002Fblob\u002Fmain\u002Fskills\u002Fpersonal\u002Fth-workflow\u002Fsubskills\u002Freceiving-code-review\u002FSKILL.md",[123,124],{"categoryNo":97,"categoryName":98,"taxonomyType":99,"taxonomyTypeDesc":100},{"categoryNo":102,"categoryName":103,"taxonomyType":104,"taxonomyTypeDesc":105},[126,108,109,110,80,113,127,114,75,128,129,130,131],"receiving code review","implementation","code review feedback","technical","feedback","verification",{"skillNo":133,"name":134,"nameZh":6,"description":135,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":136,"categories":137,"keywords":138,"publishedAt":27},"01M6DAZ4ER76ADXJ9KRFP7V3Q9","finishing-a-development-branch","Use when implementation is complete, all tests pass, and you need to decide how to integrate the work - guides completion of development work by presenting structured options for merge, PR, or cleanup","https:\u002F\u002Fgithub.com\u002Ftzeusy-org\u002Fai-bootstrap\u002Fblob\u002Fmain\u002Fskills\u002Fpersonal\u002Fth-workflow\u002Fsubskills\u002Ffinishing-a-development-branch\u002FSKILL.md",[],[139,140,141,142,75,143,111,144,145,146,114,147,148,149,80,113,150,127],"branch","development","finishing a development branch","integrate","decide","how","cleanup","pr","merge","tests","structured","options",{"skillNo":152,"name":153,"nameZh":6,"description":154,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":155,"categories":156,"keywords":157,"publishedAt":27},"01M6DAYZFWWW2YPKP89QNQR96H","executing-plans","Use when you have a written implementation plan to execute in a separate session with review checkpoints","https:\u002F\u002Fgithub.com\u002Ftzeusy-org\u002Fai-bootstrap\u002Fblob\u002Fmain\u002Fskills\u002Fpersonal\u002Fth-workflow\u002Fsubskills\u002Fexecuting-plans\u002FSKILL.md",[],[158,159,160,109,161,80,113,127,114,75,84],"plans","executing plans","plan","execute",{"skillNo":163,"name":164,"nameZh":6,"description":165,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":166,"categories":167,"keywords":168,"publishedAt":27},"01M6DAYWM2YQHYCK7C35K1D29J","dispatching-parallel-agents","Use when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies","https:\u002F\u002Fgithub.com\u002Ftzeusy-org\u002Fai-bootstrap\u002Fblob\u002Fmain\u002Fskills\u002Fpersonal\u002Fth-workflow\u002Fsubskills\u002Fdispatching-parallel-agents\u002FSKILL.md",[],[169,170,171,75,114,113,172,80,173,116,174],"parallel agents","parallel","dispatching parallel agents","state","dependencies","shared"]