[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7B3BX122WDMNFK8VBMVMBK4":3,"skill-same:01M7B3BX122WDMNFK8VBMVMBK4":45},{"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":24,"commitSha":25,"skillDirectory":26,"forksCount":14,"repositoryHtmlUrl":27,"repositoryHomepageUrl":27,"ownerHtmlUrl":28,"ownerBlogUrl":6,"ownerDescription":29,"updatedAt":30,"install":31,"resources":44},"01M7B3BX122WDMNFK8VBMVMBK4","vvkit-capturing-decisions",null,"Use when a decision, correction, or design rationale emerges that would otherwise be lost when the session ends.","vadimvitvickiy\u002Fvv-agent-kit","vadimvitvickiy","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F5019512?v=4","01M7B3ABRYF7KHBCDW6GB2XH0C","Vadim Vitvitskii","01M7B3ABSZYG9MXP1CC7BQYM25",0,"MIT","https:\u002F\u002Fgithub.com\u002Fvadimvitvickiy\u002Fvv-agent-kit\u002Fblob\u002Fmain\u002Fcodex\u002Fplugins\u002Fvvkit\u002Fskills\u002Fvvkit-capturing-decisions\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: vvkit-capturing-decisions\ndescription: \"Use when a decision, correction, or design rationale emerges that would otherwise be lost when the session ends.\"\n---\n\n# Capturing decisions\n\n**Session state is disposable. Anything that must outlive the session is promoted into the repo**,\nwherever this project keeps its decisions — at the moment it is decided, not at the end. There is no\nend: in the repo this kit came from, plans piled up for months while the decisions file beside them\nstayed an empty header.\n\n## Codex runtime\n\nLoad referenced skills by reading their SKILL.md. Surveyor, reviewer and runner\nskills are role instructions, not registered agent types or enforced tool allowlists.\nUse a generic subagent only when delegation is available and permitted; otherwise\nperform the role inline. Follow the active session's model, context and permission\nrules. User authorization takes precedence over imported workflow approval gates.\nClaude hooks and plugin commands are not active in this package. Existing\n`.claude\u002Fcontext\u002F` paths refer to project documents, not Codex configuration.\n\n| What | Goes to |\n|-|-|\n| A decision and its reasoning | The project's decision record — `docs\u002Fadr\u002F`, `docs\u002Fdecisions\u002F`, a `decisions.md`. After `$vvkit-onboard`, `.claude\u002Fcontext\u002Fdecisions.md` |\n| A validated design | Where the project keeps designs. After onboarding, `.claude\u002Fcontext\u002Fspecs\u002F` |\n| A correction about how to work | Durable memory, when the harness has one |\n| A plan in flight, scratch, tool state | The session's scratch area — `.agents\u002F` after onboarding — and stays there |\n\n- No decision home in the project: ask before creating one. A new directory is a convention imposed\n  on everyone who clones the repo.\n- **Promote into the repo it is about.** A design for another project goes to that project's repo.\n  Test: would someone cloning this repo need it?\n\n## What earns a record\n\nRecord it when the reasoning is not recoverable from the code:\n\n- A choice between viable options, and why this one.\n- A constraint not visible from any single file.\n- A rejected approach and what ruled it out — the one most needed and least written.\n- A correction from the human about how to work.\n\nDo not record what the repo already says: code structure, git history, the project's docs. Asked to\nremember something already there, record what was non-obvious about it instead.\n\n## Shape\n\n- One fact per entry: what was decided, **why**, and what it rules out.\n- Absolute dates — \"last week\" is meaningless in six months.\n- Link related records. A link to one not written yet marks something worth writing.\n- **Deferred work carries a date, a reason, and what brings it back** — \"when a second channel\n  exists\". An old deferral whose trigger never came has expired: delete it or schedule it.\n\n## Recalled records are stale by default\n\n- Before acting on a record that names a file, function or flag, **verify it still exists.**\n- Delete records that turn out wrong. An outdated record is not harmless history.\n","# Capturing decisions\n\n**Session state is disposable. Anything that must outlive the session is promoted into the repo**,\nwherever this project keeps its decisions — at the moment it is decided, not at the end. There is no\nend: in the repo this kit came from, plans piled up for months while the decisions file beside them\nstayed an empty header.\n\n## Codex runtime\n\nLoad referenced skills by reading their SKILL.md. Surveyor, reviewer and runner\nskills are role instructions, not registered agent types or enforced tool allowlists.\nUse a generic subagent only when delegation is available and permitted; otherwise\nperform the role inline. Follow the active session's model, context and permission\nrules. User authorization takes precedence over imported workflow approval gates.\nClaude hooks and plugin commands are not active in this package. Existing\n`.claude\u002Fcontext\u002F` paths refer to project documents, not Codex configuration.\n\n| What | Goes to |\n|-|-|\n| A decision and its reasoning | The project's decision record — `docs\u002Fadr\u002F`, `docs\u002Fdecisions\u002F`, a `decisions.md`. After `$vvkit-onboard`, `.claude\u002Fcontext\u002Fdecisions.md` |\n| A validated design | Where the project keeps designs. After onboarding, `.claude\u002Fcontext\u002Fspecs\u002F` |\n| A correction about how to work | Durable memory, when the harness has one |\n| A plan in flight, scratch, tool state | The session's scratch area — `.agents\u002F` after onboarding — and stays there |\n\n- No decision home in the project: ask before creating one. A new directory is a convention imposed\n  on everyone who clones the repo.\n- **Promote into the repo it is about.** A design for another project goes to that project's repo.\n  Test: would someone cloning this repo need it?\n\n## What earns a record\n\nRecord it when the reasoning is not recoverable from the code:\n\n- A choice between viable options, and why this one.\n- A constraint not visible from any single file.\n- A rejected approach and what ruled it out — the one most needed and least written.\n- A correction from the human about how to work.\n\nDo not record what the repo already says: code structure, git history, the project's docs. Asked to\nremember something already there, record what was non-obvious about it instead.\n\n## Shape\n\n- One fact per entry: what was decided, **why**, and what it rules out.\n- Absolute dates — \"last week\" is meaningless in six months.\n- Link related records. A link to one not written yet marks something worth writing.\n- **Deferred work carries a date, a reason, and what brings it back** — \"when a second channel\n  exists\". An old deferral whose trigger never came has expired: delete it or schedule it.\n\n## Recalled records are stale by default\n\n- Before acting on a record that names a file, function or flag, **verify it still exists.**\n- Delete records that turn out wrong. An outdated record is not harmless history.\n",{"name":5,"description":7},"main","cc22a222a76add5759a2df5fadf231a758691db5","codex\u002Fplugins\u002Fvvkit\u002Fskills\u002Fvvkit-capturing-decisions","https:\u002F\u002Fgithub.com\u002Fvadimvitvickiy\u002Fvv-agent-kit","https:\u002F\u002Fgithub.com\u002Fvadimvitvickiy","Senior iOS engineer. Architecture, SDKs and apps for iOS, tvOS and watchOS.","2026-11-13 19:10:29",{"source":8,"skillName":5,"commands":32,"prompt":42,"zipAvailable":43},[33,36,39],{"tool":34,"command":35},"npx","npx skills add vadimvitvickiy\u002Fvv-agent-kit --skill vvkit-capturing-decisions",{"tool":37,"command":38},"bunx","bunx skills add vadimvitvickiy\u002Fvv-agent-kit --skill vvkit-capturing-decisions",{"tool":40,"command":41},"pnpm","pnpm dlx skills add vadimvitvickiy\u002Fvv-agent-kit --skill vvkit-capturing-decisions","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fvadimvitvickiy\u002Fvv-agent-kit\u002Fblob\u002Fmain\u002Fcodex\u002Fplugins\u002Fvvkit\u002Fskills\u002Fvvkit-capturing-decisions\u002FSKILL.md",true,[],[46,53,60,67,74,81],{"skillNo":47,"name":48,"nameZh":6,"description":49,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":50,"categories":51,"keywords":52,"publishedAt":19},"01M7B3JN7VG0YJ4JB8RP6HYZSJ","no-heading","Use when proving that the validator rejects a body with no H1 and a force-loading @-link.","https:\u002F\u002Fgithub.com\u002Fvadimvitvickiy\u002Fvv-agent-kit\u002Fblob\u002Fmain\u002Ftests\u002Ffixtures\u002Fskills\u002Fno-heading\u002FSKILL.md",[],[],{"skillNo":54,"name":55,"nameZh":6,"description":56,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":57,"categories":58,"keywords":59,"publishedAt":19},"01M7B3JJMEW4E710ZG6HYJ7BWV","wrong-name-does-not-match-dir","Dispatches a subagent per task and reviews between each one.","https:\u002F\u002Fgithub.com\u002Fvadimvitvickiy\u002Fvv-agent-kit\u002Fblob\u002Fmain\u002Ftests\u002Ffixtures\u002Fskills\u002Fbroken-skill\u002FSKILL.md",[],[],{"skillNo":61,"name":62,"nameZh":6,"description":63,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":64,"categories":65,"keywords":66,"publishedAt":19},"01M7B3JGE9MFT1HRP41YRVKN97","writing-tests","Use when adding or changing behavior, fixing a bug, or judging whether an existing or generated test earns its place.","https:\u002F\u002Fgithub.com\u002Fvadimvitvickiy\u002Fvv-agent-kit\u002Fblob\u002Fmain\u002Fskills\u002Fwriting-tests\u002FSKILL.md",[],[],{"skillNo":68,"name":69,"nameZh":6,"description":70,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":71,"categories":72,"keywords":73,"publishedAt":19},"01M7B3JD5X32VEBDBN7HB8E17Z","writing-skills","Use when authoring or editing a skill, agent, command or hook for this kit, or when deciding whether a piece of guidance belongs in a skill at all.","https:\u002F\u002Fgithub.com\u002Fvadimvitvickiy\u002Fvv-agent-kit\u002Fblob\u002Fmain\u002Fskills\u002Fwriting-skills\u002FSKILL.md",[],[],{"skillNo":75,"name":76,"nameZh":6,"description":77,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":78,"categories":79,"keywords":80,"publishedAt":19},"01M7B3J992MZH2QVZRED0DRPD9","writing-project-instructions","Use when creating or editing a CLAUDE.md or AGENTS.md, when it has grown long, or when a rule in it also exists in an installed skill.","https:\u002F\u002Fgithub.com\u002Fvadimvitvickiy\u002Fvv-agent-kit\u002Fblob\u002Fmain\u002Fskills\u002Fwriting-project-instructions\u002FSKILL.md",[],[],{"skillNo":82,"name":83,"nameZh":6,"description":84,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":85,"categories":86,"keywords":87,"publishedAt":19},"01M7B3J55C5WPWN20QXP9ET848","writing-logs","Use when adding or reviewing log statements, or when deciding what level a message belongs at.","https:\u002F\u002Fgithub.com\u002Fvadimvitvickiy\u002Fvv-agent-kit\u002Fblob\u002Fmain\u002Fskills\u002Fwriting-logs\u002FSKILL.md",[],[]]