[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M78FG4HYA23C802N8SH9MHSC":3,"skill-same:01M78FG4HYA23C802N8SH9MHSC":97},{"skillNo":4,"name":5,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":15,"categories":16,"keywords":17,"publishedAt":18,"linkOnly":19,"markdownContent":20,"markdownBody":20,"frontMatter":21,"refName":22,"commitSha":23,"skillDirectory":24,"forksCount":25,"repositoryHtmlUrl":26,"repositoryHomepageUrl":6,"ownerHtmlUrl":27,"ownerBlogUrl":28,"ownerDescription":29,"updatedAt":30,"install":31,"resources":44},"01M78FG4HYA23C802N8SH9MHSC","project-documentation-architect",null,"poppyTM\u002Foride","poppyTM","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F339400917?v=4","01M78F6YNKFR5S5JQR27X9F09Z","Poppy Team","01M78F6YP8ZZTRES9X8Q2ZAD21",1,"MIT","https:\u002F\u002Fgithub.com\u002FpoppyTM\u002Foride\u002Fblob\u002Fmain\u002F.ai\u002Fskills\u002Fproject-documentation-architect\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"# Project Documentation Architect\n\nBuild and maintain implementation-ready, living project documentation —\nproduct, architecture, contracts, evidence, quality gates — in canonical\n`en-US` plus synchronized `pt-BR`, with the least workforce sufficient.\nPortable core: `~\u002Fproject-documentation-architect\u002F` (agentskills.io format);\nthis package is the Prumo-native adapter of that core.\n\n## Purpose\nTurn `idea -> context -> requirements -> research -> decisions ->\ncontracts -> documentation -> readiness -> execution -> evidence ->\ndelta -> continuous maintenance`, producing a versioned, evidence-backed\ndocumentation system (not a pile of Markdown) that lets future agents work\nwithout rediscovering everything.\n\n## Use when\nCreating, initializing, bootstrapping, adopting, or formally planning a\nsoftware project before substantial implementation begins; adopting an\nexisting repo that lacks adequate docs; maintaining docs of an already\ndocumented project (delta); or when asked for an implementation bible,\nliving book, full architecture, or agent handoff documentation.\n\n## Do not use when\nSingle-function bug fixes, trivial edits inside an already documented\nproject, explicitly disposable one-off scripts, or pure code review with\nno documentation mandate. For small changes inside documented projects,\nrun Mode DELTA only.\n\n## Required context\n- User intent or briefing (GENESIS) or repo snapshot (ADOPTION\u002FDELTA).\n- Detected documentation profiles (see `references\u002Fprofiles.md`).\n- `docs\u002Fproject-docs.json` manifest when it already exists; create it first\n  when it does not (template: `templates\u002Fproject-docs.json`).\n\n## Procedure\n1. Select mode: GENESIS (no trusted docs yet), ADOPTION (repo exists, docs\n   missing\u002Fpartial\u002Funtrusted — inspect code, tests, CI, config, runtime\n   first, then write a Gap Matrix and fix only the delta), DELTA (docs exist\n   — update only impacted capabilities, contracts, tests, docs, risks,\n   migrations, translations). Detail: `references\u002Fmodes.md`.\n2. Detect profiles and resolve the mandatory contract pack per profile\n   (`references\u002Fprofiles.md`). Write\u002Fupdate `docs\u002Fproject-docs.json` first:\n   identity, profiles, contracts, semantic roles, statuses, owners.\n3. Select the least workforce sufficient (`references\u002Forchestration.md`):\n   tiny CLI = orchestrator + architect + one documenter + translator;\n   add product, research, UI\u002FUX, a11y, security, performance, dependency,\n   ADR, traceability, parity-review, audit roles only as profiles demand.\n   Never assign two writers to the same canonical artifact concurrently.\n4. Draft canonical `en-US` docs, then translate impacted pairs to `pt-BR`,\n   then parity-review (`references\u002Fbilingual.md`). Technical errors found\n   during translation are fixed in `en-US` first and re-propagated — never\n   patch `pt-BR` alone.\n5. Run `scripts\u002Fverify.sh`, complete `checks\u002Fpost-flight.md`, and record a\n   documentation delta (changed capabilities\u002Fcontracts, impacted\n   docs\u002Ftests\u002Ftranslations, severity, requires_review).\n\n## Decision rules\n- Never invent features, requirements, commands, APIs, benchmarks, files,\n  or decisions. Unknowns become OPEN, ASSUMPTION, RESEARCH REQUIRED, or\n  BLOCKING QUESTION.\n- Material claims need `claim -> source -> evidence -> verification ->\n  decision`. `verified`, `safe`, `complete`, and `done` are forbidden\n  without verifiable semantics.\n- Depth follows `complexity + risk + impact + irreversibility`. No empty\n  checklist files; group content for simple projects.\n- Human-approved decisions outrank inference; real behavior + valid tests\n  + approved contracts outrank unverified assertions.\n- Contradictions are preserved as CONTRADICTION records (both claims plus\n  evidence) and resolved via the authority model or the human — never\n  merged silently.\n\n## Evidence required\n- Automated test runs, build outputs, or verification logs where the skill\n  touches behavior; `scripts\u002Fverify.sh` output for documentation runs.\n- Every normative MUST links to an acceptance criterion plus a test pointer.\n- Required evidence for sign-off: `review` (and `test` when implementation\n  or executable checks are involved).\n\n## Output contract\n- Updated `docs\u002Fproject-docs.json` manifest.\n- Canonical `en-US` documents plus synchronized `pt-BR` versions for every\n  required pair (states CURRENT or IN_REVIEW, never silent STALE).\n- Documentation delta record plus handoff microcontexts (one loadable\n  context per work stream — never a full dump).\n- Completed `checks\u002Fpost-flight.md`; residual risks and open questions\n  recorded explicitly.\n",{},"main","1cd515630b8ceb57777d466bee4970fe7c2e30e0",".ai\u002Fskills\u002Fproject-documentation-architect",0,"https:\u002F\u002Fgithub.com\u002FpoppyTM\u002Foride","https:\u002F\u002Fgithub.com\u002FpoppyTM","https:\u002F\u002Fpoppy.lat","Construímos linguagens de programação e ferramentas para quem lê código com o mesmo cuidado com que escreve.","2026-09-30 10:15:52",{"source":7,"skillName":5,"commands":32,"prompt":42,"zipAvailable":43},[33,36,39],{"tool":34,"command":35},"npx","npx skills add poppyTM\u002Foride --skill project-documentation-architect",{"tool":37,"command":38},"bunx","bunx skills add poppyTM\u002Foride --skill project-documentation-architect",{"tool":40,"command":41},"pnpm","pnpm dlx skills add poppyTM\u002Foride --skill project-documentation-architect","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FpoppyTM\u002Foride\u002Fblob\u002Fmain\u002F.ai\u002Fskills\u002Fproject-documentation-architect\u002FSKILL.md",true,[45,51,55,59,63,67,71,75,79,85,89,93],{"path":46,"resourceType":47,"resourceTypeDesc":48,"sizeBytes":49,"sourceHtmlUrl":50},"checks\u002Fpost-flight.md","REFERENCE","参考文档",484,"https:\u002F\u002Fgithub.com\u002FpoppyTM\u002Foride\u002Fblob\u002Fmain\u002F.ai\u002Fskills\u002Fproject-documentation-architect\u002Fchecks\u002Fpost-flight.md",{"path":52,"resourceType":47,"resourceTypeDesc":48,"sizeBytes":53,"sourceHtmlUrl":54},"checks\u002Fpre-flight.md",477,"https:\u002F\u002Fgithub.com\u002FpoppyTM\u002Foride\u002Fblob\u002Fmain\u002F.ai\u002Fskills\u002Fproject-documentation-architect\u002Fchecks\u002Fpre-flight.md",{"path":56,"resourceType":47,"resourceTypeDesc":48,"sizeBytes":57,"sourceHtmlUrl":58},"examples\u002Ftiny-cli.md",376,"https:\u002F\u002Fgithub.com\u002FpoppyTM\u002Foride\u002Fblob\u002Fmain\u002F.ai\u002Fskills\u002Fproject-documentation-architect\u002Fexamples\u002Ftiny-cli.md",{"path":60,"resourceType":47,"resourceTypeDesc":48,"sizeBytes":61,"sourceHtmlUrl":62},"manifest.json",2043,"https:\u002F\u002Fgithub.com\u002FpoppyTM\u002Foride\u002Fblob\u002Fmain\u002F.ai\u002Fskills\u002Fproject-documentation-architect\u002Fmanifest.json",{"path":64,"resourceType":47,"resourceTypeDesc":48,"sizeBytes":65,"sourceHtmlUrl":66},"references\u002Fbilingual.md",639,"https:\u002F\u002Fgithub.com\u002FpoppyTM\u002Foride\u002Fblob\u002Fmain\u002F.ai\u002Fskills\u002Fproject-documentation-architect\u002Freferences\u002Fbilingual.md",{"path":68,"resourceType":47,"resourceTypeDesc":48,"sizeBytes":69,"sourceHtmlUrl":70},"references\u002Fmodes.md",856,"https:\u002F\u002Fgithub.com\u002FpoppyTM\u002Foride\u002Fblob\u002Fmain\u002F.ai\u002Fskills\u002Fproject-documentation-architect\u002Freferences\u002Fmodes.md",{"path":72,"resourceType":47,"resourceTypeDesc":48,"sizeBytes":73,"sourceHtmlUrl":74},"references\u002Forchestration.md",894,"https:\u002F\u002Fgithub.com\u002FpoppyTM\u002Foride\u002Fblob\u002Fmain\u002F.ai\u002Fskills\u002Fproject-documentation-architect\u002Freferences\u002Forchestration.md",{"path":76,"resourceType":47,"resourceTypeDesc":48,"sizeBytes":77,"sourceHtmlUrl":78},"references\u002Fprofiles.md",1079,"https:\u002F\u002Fgithub.com\u002FpoppyTM\u002Foride\u002Fblob\u002Fmain\u002F.ai\u002Fskills\u002Fproject-documentation-architect\u002Freferences\u002Fprofiles.md",{"path":80,"resourceType":81,"resourceTypeDesc":82,"sizeBytes":83,"sourceHtmlUrl":84},"scripts\u002Fverify.sh","SCRIPT","脚本",1560,"https:\u002F\u002Fgithub.com\u002FpoppyTM\u002Foride\u002Fblob\u002Fmain\u002F.ai\u002Fskills\u002Fproject-documentation-architect\u002Fscripts\u002Fverify.sh",{"path":86,"resourceType":47,"resourceTypeDesc":48,"sizeBytes":87,"sourceHtmlUrl":88},"templates\u002Fadr.md",241,"https:\u002F\u002Fgithub.com\u002FpoppyTM\u002Foride\u002Fblob\u002Fmain\u002F.ai\u002Fskills\u002Fproject-documentation-architect\u002Ftemplates\u002Fadr.md",{"path":90,"resourceType":47,"resourceTypeDesc":48,"sizeBytes":91,"sourceHtmlUrl":92},"templates\u002Fmicrocontext.md",225,"https:\u002F\u002Fgithub.com\u002FpoppyTM\u002Foride\u002Fblob\u002Fmain\u002F.ai\u002Fskills\u002Fproject-documentation-architect\u002Ftemplates\u002Fmicrocontext.md",{"path":94,"resourceType":47,"resourceTypeDesc":48,"sizeBytes":95,"sourceHtmlUrl":96},"templates\u002Fproject-docs.json",314,"https:\u002F\u002Fgithub.com\u002FpoppyTM\u002Foride\u002Fblob\u002Fmain\u002F.ai\u002Fskills\u002Fproject-documentation-architect\u002Ftemplates\u002Fproject-docs.json",[98,104,110,117,124,131],{"skillNo":99,"name":100,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":101,"categories":102,"keywords":103,"publishedAt":18},"01M78FHQN254KEH0DETXT5JM29","zoom-reflow","https:\u002F\u002Fgithub.com\u002FpoppyTM\u002Foride\u002Fblob\u002Fmain\u002F.ai\u002Fskills\u002Fzoom-reflow\u002FSKILL.md",[],[],{"skillNo":105,"name":106,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":107,"categories":108,"keywords":109,"publishedAt":18},"01M78FHP1880S695V8GQEE0RXK","wireframe-styleguide","https:\u002F\u002Fgithub.com\u002FpoppyTM\u002Foride\u002Fblob\u002Fmain\u002F.ai\u002Fskills\u002Fwireframe-styleguide\u002FSKILL.md",[],[],{"skillNo":111,"name":112,"nameZh":6,"description":113,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":114,"categories":115,"keywords":116,"publishedAt":18},"01M78FHHYM6AN2H819FABW01DZ","visual-regression","Pixel-by-pixel snapshot testing, Playwright integration, dynamic content masking, deterministic font rendering, and cross-browser CI gates","https:\u002F\u002Fgithub.com\u002FpoppyTM\u002Foride\u002Fblob\u002Fmain\u002F.ai\u002Fskills\u002Fvisual-regression\u002FSKILL.md",[],[],{"skillNo":118,"name":119,"nameZh":6,"description":120,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":121,"categories":122,"keywords":123,"publishedAt":18},"01M78FHE53D8DD0QVRY5C37DA4","ui-implementation","Component-driven UI implementation, multi-state matrix (default, hover, focus-visible, active, disabled, loading, empty, error), DTCG design tokens, responsive layout contracts, and accessibility tree mapping.","https:\u002F\u002Fgithub.com\u002FpoppyTM\u002Foride\u002Fblob\u002Fmain\u002F.ai\u002Fskills\u002Fui-implementation\u002FSKILL.md",[],[],{"skillNo":125,"name":126,"nameZh":6,"description":127,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":128,"categories":129,"keywords":130,"publishedAt":18},"01M78FHBJ1KXFF734GFE509TBJ","tui-editor-engine","Text buffer and editing semantics for a terminal code editor — index conversion, transaction-first editing, multi-cursor invariants, undo grouping, and large-file behaviour.","https:\u002F\u002Fgithub.com\u002FpoppyTM\u002Foride\u002Fblob\u002Fmain\u002F.ai\u002Fskills\u002Ftui-editor-engine\u002FSKILL.md",[],[],{"skillNo":132,"name":133,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":134,"categories":135,"keywords":136,"publishedAt":18},"01M78FH9X6CPJX1H61ZDWTTVW8","tree-sitter-context-indexing","https:\u002F\u002Fgithub.com\u002FpoppyTM\u002Foride\u002Fblob\u002Fmain\u002F.ai\u002Fskills\u002Ftree-sitter-context-indexing\u002FSKILL.md",[],[]]