[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M758FHBXMPVTK7WJ00AW3366":3,"skill-same:01M758FHBXMPVTK7WJ00AW3366":71},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":27,"commitSha":28,"skillDirectory":29,"forksCount":30,"repositoryHtmlUrl":31,"repositoryHomepageUrl":6,"ownerHtmlUrl":32,"ownerBlogUrl":6,"ownerDescription":33,"updatedAt":34,"install":35,"resources":48},"01M758FHBXMPVTK7WJ00AW3366","adr",null,"Trigger: ADR, architecture decision, decision record, por qué elegimos X, documentar decisión. Teach agents how to find, read, create, and update Architecture Decision Records across all workflows.","davidcoachdev\u002Fdcfiles","davidcoachdev","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F69812733?v=4","01M758C4BR16TAV1N47W319E9V","David H. Caycedo Blum.","01M758C4CCZA2ZYGA0BGMXCDRH",1,"MIT","https:\u002F\u002Fgithub.com\u002Fdavidcoachdev\u002Fdcfiles\u002Fblob\u002Fmain\u002Fconfig\u002F.config\u002Fopencode\u002Fskills\u002Fadr\u002FSKILL.md",[],[],"2026-11-12 13:55:43",false,"---\nname: adr\ndescription: \"Trigger: ADR, architecture decision, decision record, por qué elegimos X, documentar decisión. Teach agents how to find, read, create, and update Architecture Decision Records across all workflows.\"\nlicense: MIT\nmetadata:\n  author: gentleman-programming\n  version: \"1.0\"\n---\n\n# ADR - Architecture Decision Records\n\n## Activation Contract\n\nUse this skill when:\n- Creating a new architecture decision record\n- Consulting existing ADRs before making a decision\n- Updating an ADR's status (accepted, deprecated, superseded)\n- Linking ADRs to specs, designs, or implementation tasks\n\nDo not use for:\n- Trivial decisions (ESLint vs Prettier, tab size)\n- Implementation details that don't affect architecture\n- Personal preferences without team impact\n\n## Hard Rules\n\n- ADRs live in `docs\u002Fadr\u002F` at the project root\n- Every ADR must be listed in `docs\u002Fadr\u002Findex.md`\n- When creating an ADR, you MUST update the index\n- Use the template from `assets\u002Ftemplate.md` exactly — do not deviate\n- ADRs are numbered sequentially: `001-short-name.md`, `002-another-decision.md`\n- When superseding an ADR, you MUST add a `Superseded by` link in both the old and new ADR\n- ADRs are the canonical **S2 (decisions)** tier of the project knowledge base — see `ck:context-architecture` → *The Second Axis: Knowledge Stability*. S2 is always file-canonical because ADRs get reviewed in pull requests. Other artifacts (Engram topic_keys, `context\u002F`, specs) link to `docs\u002Fadr\u002F` and MUST NOT copy ADR content.\n\n## Decision Gates\n\n| Situation | Action |\n|-----------|--------|\n| New architectural decision with real tradeoffs | Create ADR |\n| Decision affects multiple workflows or teams | Create ADR |\n| Trivial tooling or style choice | Skip ADR |\n| Decision already documented in an existing ADR | Reference it, don't duplicate |\n| Previous ADR is now wrong or outdated | Create new ADR, mark old as superseded |\n\n## Execution Steps\n\n### Finding Existing ADRs\n\n1. Read `docs\u002Fadr\u002Findex.md` to see all ADRs with their status and keywords\n2. Identify ADRs relevant to your current task by:\n   - Scanning titles for domain match\n   - Checking keywords column for specific terms\n   - Looking at status (prefer `Accepted`, avoid `Superseded` unless tracing history)\n3. Read only the relevant ADR files — do not load all ADRs\n\n### Creating a New ADR\n\n1. Determine the next ADR number by reading `docs\u002Fadr\u002Findex.md`\n2. Copy `assets\u002Ftemplate.md` to `docs\u002Fadr\u002F{NNN}-{short-name}.md`\n3. Fill in all sections:\n   - **Title**: Number + short descriptive name\n   - **Status**: Start with `Proposed`\n   - **Context**: What problem are we solving? What options did we consider?\n   - **Decision**: What did we choose and WHY? (the why is critical)\n   - **Consequences**: What changes? What becomes easier? What becomes harder?\n   - **Superseded by**: Leave empty unless this replaces another ADR\n4. Update `docs\u002Fadr\u002Findex.md` by adding a row to the table\n5. Run `bash {skill-dir}\u002Fscripts\u002Fupdate-index.sh` to verify the index is complete\n\n### Updating an ADR\n\n1. **Status changes**: Update the `Status` field (Proposed → Accepted, Accepted → Deprecated, etc.)\n2. **Superseding**: When creating ADR-NNN that replaces ADR-MMM:\n   - In ADR-MMM: change Status to `Superseded`, add `Superseded by: [ADR-NNN](.\u002FNNN-name.md)`\n   - In ADR-NNN: add `Supersedes: [ADR-MMM](.\u002FMMM-name.md)` in the header\n3. **Content updates**: If the decision rationale changes, update the ADR and add a revision date\n\n### Linking ADRs to Work\n\n- **In specs\u002Fkits**: Reference ADRs that constrain the design: `See [ADR-002](..\u002Fdocs\u002Fadr\u002F002-hexagonal.md)`\n- **In designs**: Link ADRs that informed the visual\u002FUX decisions\n- **In implementation tasks**: Reference ADRs that explain why the code is structured a certain way\n- **In code comments**: For critical architectural choices, add a comment: `\u002F\u002F See docs\u002Fadr\u002F001-auth-jwt.md`\n\n### Regenerating the Index\n\nIf the index is out of sync or you want to verify it:\n\n```bash\nbash {skill-dir}\u002Fscripts\u002Fupdate-index.sh\n```\n\nThis script:\n- Scans `docs\u002Fadr\u002F*.md` (excluding `index.md`)\n- Extracts title, status, and keywords from each ADR\n- Regenerates `docs\u002Fadr\u002Findex.md` with a complete table\n- Reports any ADRs that are missing required fields\n\n## Output Contract\n\nWhen creating an ADR, return:\n- The path to the new ADR file\n- Confirmation that the index was updated\n- Any warnings about missing fields or formatting issues\n\nWhen consulting ADRs, return:\n- Which ADRs were consulted\n- Key decisions that affect the current task\n- Any conflicts or outdated decisions found\n\n## References\n\n- `assets\u002Ftemplate.md` — The ADR template (use exactly)\n- `scripts\u002Fupdate-index.sh` — Script to regenerate the index from ADR files\n","# ADR - Architecture Decision Records\n\n## Activation Contract\n\nUse this skill when:\n- Creating a new architecture decision record\n- Consulting existing ADRs before making a decision\n- Updating an ADR's status (accepted, deprecated, superseded)\n- Linking ADRs to specs, designs, or implementation tasks\n\nDo not use for:\n- Trivial decisions (ESLint vs Prettier, tab size)\n- Implementation details that don't affect architecture\n- Personal preferences without team impact\n\n## Hard Rules\n\n- ADRs live in `docs\u002Fadr\u002F` at the project root\n- Every ADR must be listed in `docs\u002Fadr\u002Findex.md`\n- When creating an ADR, you MUST update the index\n- Use the template from `assets\u002Ftemplate.md` exactly — do not deviate\n- ADRs are numbered sequentially: `001-short-name.md`, `002-another-decision.md`\n- When superseding an ADR, you MUST add a `Superseded by` link in both the old and new ADR\n- ADRs are the canonical **S2 (decisions)** tier of the project knowledge base — see `ck:context-architecture` → *The Second Axis: Knowledge Stability*. S2 is always file-canonical because ADRs get reviewed in pull requests. Other artifacts (Engram topic_keys, `context\u002F`, specs) link to `docs\u002Fadr\u002F` and MUST NOT copy ADR content.\n\n## Decision Gates\n\n| Situation | Action |\n|-----------|--------|\n| New architectural decision with real tradeoffs | Create ADR |\n| Decision affects multiple workflows or teams | Create ADR |\n| Trivial tooling or style choice | Skip ADR |\n| Decision already documented in an existing ADR | Reference it, don't duplicate |\n| Previous ADR is now wrong or outdated | Create new ADR, mark old as superseded |\n\n## Execution Steps\n\n### Finding Existing ADRs\n\n1. Read `docs\u002Fadr\u002Findex.md` to see all ADRs with their status and keywords\n2. Identify ADRs relevant to your current task by:\n   - Scanning titles for domain match\n   - Checking keywords column for specific terms\n   - Looking at status (prefer `Accepted`, avoid `Superseded` unless tracing history)\n3. Read only the relevant ADR files — do not load all ADRs\n\n### Creating a New ADR\n\n1. Determine the next ADR number by reading `docs\u002Fadr\u002Findex.md`\n2. Copy `assets\u002Ftemplate.md` to `docs\u002Fadr\u002F{NNN}-{short-name}.md`\n3. Fill in all sections:\n   - **Title**: Number + short descriptive name\n   - **Status**: Start with `Proposed`\n   - **Context**: What problem are we solving? What options did we consider?\n   - **Decision**: What did we choose and WHY? (the why is critical)\n   - **Consequences**: What changes? What becomes easier? What becomes harder?\n   - **Superseded by**: Leave empty unless this replaces another ADR\n4. Update `docs\u002Fadr\u002Findex.md` by adding a row to the table\n5. Run `bash {skill-dir}\u002Fscripts\u002Fupdate-index.sh` to verify the index is complete\n\n### Updating an ADR\n\n1. **Status changes**: Update the `Status` field (Proposed → Accepted, Accepted → Deprecated, etc.)\n2. **Superseding**: When creating ADR-NNN that replaces ADR-MMM:\n   - In ADR-MMM: change Status to `Superseded`, add `Superseded by: [ADR-NNN](.\u002FNNN-name.md)`\n   - In ADR-NNN: add `Supersedes: [ADR-MMM](.\u002FMMM-name.md)` in the header\n3. **Content updates**: If the decision rationale changes, update the ADR and add a revision date\n\n### Linking ADRs to Work\n\n- **In specs\u002Fkits**: Reference ADRs that constrain the design: `See [ADR-002](..\u002Fdocs\u002Fadr\u002F002-hexagonal.md)`\n- **In designs**: Link ADRs that informed the visual\u002FUX decisions\n- **In implementation tasks**: Reference ADRs that explain why the code is structured a certain way\n- **In code comments**: For critical architectural choices, add a comment: `\u002F\u002F See docs\u002Fadr\u002F001-auth-jwt.md`\n\n### Regenerating the Index\n\nIf the index is out of sync or you want to verify it:\n\n```bash\nbash {skill-dir}\u002Fscripts\u002Fupdate-index.sh\n```\n\nThis script:\n- Scans `docs\u002Fadr\u002F*.md` (excluding `index.md`)\n- Extracts title, status, and keywords from each ADR\n- Regenerates `docs\u002Fadr\u002Findex.md` with a complete table\n- Reports any ADRs that are missing required fields\n\n## Output Contract\n\nWhen creating an ADR, return:\n- The path to the new ADR file\n- Confirmation that the index was updated\n- Any warnings about missing fields or formatting issues\n\nWhen consulting ADRs, return:\n- Which ADRs were consulted\n- Key decisions that affect the current task\n- Any conflicts or outdated decisions found\n\n## References\n\n- `assets\u002Ftemplate.md` — The ADR template (use exactly)\n- `scripts\u002Fupdate-index.sh` — Script to regenerate the index from ADR files\n",{"name":5,"license":15,"metadata":24,"description":7},{"author":25,"version":26},"gentleman-programming","1.0","main","5dc86f90a5cbe45db3acd917825461b3ed6937fb","config\u002F.config\u002Fopencode\u002Fskills\u002Fadr",0,"https:\u002F\u002Fgithub.com\u002Fdavidcoachdev\u002Fdcfiles","https:\u002F\u002Fgithub.com\u002Fdavidcoachdev","🌐 Apasionado por crear soluciones web escalables y eficientes. \r\n🧑‍🏫 Coach Dev.\r\n💻 Frontend Dev. \r\n🎚️Backend Dev.\r\n📊 Agile\u002FScrum.\r\n🚀100% remoto.","2026-08-26 07:28:05",{"source":8,"skillName":5,"commands":36,"prompt":46,"zipAvailable":47},[37,40,43],{"tool":38,"command":39},"npx","npx skills add davidcoachdev\u002Fdcfiles --skill adr",{"tool":41,"command":42},"bunx","bunx skills add davidcoachdev\u002Fdcfiles --skill adr",{"tool":44,"command":45},"pnpm","pnpm dlx skills add davidcoachdev\u002Fdcfiles --skill adr","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fdavidcoachdev\u002Fdcfiles\u002Fblob\u002Fmain\u002Fconfig\u002F.config\u002Fopencode\u002Fskills\u002Fadr\u002FSKILL.md",true,[49,55,61,65],{"path":50,"resourceType":51,"resourceTypeDesc":52,"sizeBytes":53,"sourceHtmlUrl":54},"assets\u002Ftemplate.md","ASSET","资产文件",1281,"https:\u002F\u002Fgithub.com\u002Fdavidcoachdev\u002Fdcfiles\u002Fblob\u002Fmain\u002Fconfig\u002F.config\u002Fopencode\u002Fskills\u002Fadr\u002Fassets\u002Ftemplate.md",{"path":56,"resourceType":57,"resourceTypeDesc":58,"sizeBytes":59,"sourceHtmlUrl":60},"hooks\u002Fpost-commit","OTHER","其他",1617,"https:\u002F\u002Fgithub.com\u002Fdavidcoachdev\u002Fdcfiles\u002Fblob\u002Fmain\u002Fconfig\u002F.config\u002Fopencode\u002Fskills\u002Fadr\u002Fhooks\u002Fpost-commit",{"path":62,"resourceType":57,"resourceTypeDesc":58,"sizeBytes":63,"sourceHtmlUrl":64},"hooks\u002Fpre-commit",1311,"https:\u002F\u002Fgithub.com\u002Fdavidcoachdev\u002Fdcfiles\u002Fblob\u002Fmain\u002Fconfig\u002F.config\u002Fopencode\u002Fskills\u002Fadr\u002Fhooks\u002Fpre-commit",{"path":66,"resourceType":67,"resourceTypeDesc":68,"sizeBytes":69,"sourceHtmlUrl":70},"scripts\u002Fupdate-index.sh","SCRIPT","脚本",3394,"https:\u002F\u002Fgithub.com\u002Fdavidcoachdev\u002Fdcfiles\u002Fblob\u002Fmain\u002Fconfig\u002F.config\u002Fopencode\u002Fskills\u002Fadr\u002Fscripts\u002Fupdate-index.sh",[72,80,87,94,101,108],{"skillNo":73,"name":74,"nameZh":6,"description":75,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":76,"licenseFileUrl":6,"sourceHtmlUrl":77,"categories":78,"keywords":79,"publishedAt":19},"01M7740FETMZY1VTYAEFY1TWY7","zustand-5","Zustand 5 state management patterns. Trigger: When managing React state with Zustand.","Apache-2.0","https:\u002F\u002Fgithub.com\u002Fdavidcoachdev\u002Fdcfiles\u002Fblob\u002Fmain\u002Fconfig\u002F.config\u002Fopencode\u002Fskills\u002Fzustand-5\u002FSKILL.md",[],[],{"skillNo":81,"name":82,"nameZh":6,"description":83,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":76,"licenseFileUrl":6,"sourceHtmlUrl":84,"categories":85,"keywords":86,"publishedAt":19},"01M773ZZM9V68SA1AKP4WF4J29","zod-4","Zod 4 schema validation patterns. Trigger: When using Zod for validation - breaking changes from v3.","https:\u002F\u002Fgithub.com\u002Fdavidcoachdev\u002Fdcfiles\u002Fblob\u002Fmain\u002Fconfig\u002F.config\u002Fopencode\u002Fskills\u002Fzod-4\u002FSKILL.md",[],[],{"skillNo":88,"name":89,"nameZh":6,"description":90,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":76,"licenseFileUrl":6,"sourceHtmlUrl":91,"categories":92,"keywords":93,"publishedAt":19},"01M773ZJFR90CQAY0N9QR40QVP","x-bookmark-quote-posts","Workflow para revisar bookmarks de X\u002FTwitter y convertirlos en drafts de quote posts. Accede a la sección de bookmarks vía browser headless, extrae posts recientes, y genera drafts con voz personal del usuario. No publica ni muta X — solo genera contenido para revisión. Trigger: X bookmarks, Twitter bookmarks, quote posts, bookmark automation, crear quote posts, revisar bookmarks, growth content X.","https:\u002F\u002Fgithub.com\u002Fdavidcoachdev\u002Fdcfiles\u002Fblob\u002Fmain\u002Fconfig\u002F.config\u002Fopencode\u002Fskills\u002Fx-bookmark-quote-posts\u002FSKILL.md",[],[],{"skillNo":95,"name":96,"nameZh":6,"description":97,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":98,"categories":99,"keywords":100,"publishedAt":19},"01M773Z2RGV3786FV310SDB0YD","writing-skills","Use when creating new skills, editing existing skills, or verifying skills work before deployment","https:\u002F\u002Fgithub.com\u002Fdavidcoachdev\u002Fdcfiles\u002Fblob\u002Fmain\u002Fconfig\u002F.config\u002Fopencode\u002Fskills\u002Fwriting-skills\u002FSKILL.md",[],[],{"skillNo":102,"name":103,"nameZh":6,"description":104,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":105,"categories":106,"keywords":107,"publishedAt":19},"01M773YJH3KDSW467CSS63CSRJ","writing-plans","Use when you have a spec or requirements for a multi-step task, before touching code","https:\u002F\u002Fgithub.com\u002Fdavidcoachdev\u002Fdcfiles\u002Fblob\u002Fmain\u002Fconfig\u002F.config\u002Fopencode\u002Fskills\u002Fwriting-plans\u002FSKILL.md",[],[],{"skillNo":109,"name":110,"nameZh":6,"description":111,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":76,"licenseFileUrl":6,"sourceHtmlUrl":112,"categories":113,"keywords":114,"publishedAt":19},"01M773Y3S3H2CPRK5S8YFHWB5C","work-unit-commits","Plan commits as reviewable work units. Trigger: implementation, commit splitting, chained PRs, or keeping tests and docs with code.","https:\u002F\u002Fgithub.com\u002Fdavidcoachdev\u002Fdcfiles\u002Fblob\u002Fmain\u002Fconfig\u002F.config\u002Fopencode\u002Fskills\u002Fwork-unit-commits\u002FSKILL.md",[],[]]