[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M72TFVT7R3YVK4AEA3D3149C":3,"skill-same:01M72TFVT7R3YVK4AEA3D3149C":82},{"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":23,"commitSha":24,"skillDirectory":25,"forksCount":26,"repositoryHtmlUrl":27,"repositoryHomepageUrl":6,"ownerHtmlUrl":28,"ownerBlogUrl":29,"ownerDescription":6,"updatedAt":30,"install":31,"resources":44},"01M72TFVT7R3YVK4AEA3D3149C","ywc-wayfinder",null,"(ywc) Use when a large or uncertain change needs multi-session discovery with a deterministic local map and exactly one active ticket before planning or implementation. Triggers: \"wayfinder\", \"길찾기\", \"discovery map\", \"multi-session discovery\", \"탐색 ticket\", \"経路整理\", \"探索マップ\", \"ywc-wayfinder\". Do not use for ordinary planning (use ywc-plan), idea clarification (use ywc-brainstorm), direct implementation, or tracker\u002Fdatabase writes outside the local Markdown map.","yongwoon\u002Fywc-agent-toolkit","yongwoon","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F9317029?v=4","01M72SZSF6VKANKG5QTMV4V95S","01M72SZSG8HHC3W2CV5P7EJ5AH",8,"MIT","https:\u002F\u002Fgithub.com\u002Fyongwoon\u002Fywc-agent-toolkit\u002Fblob\u002Fmain\u002Fcodex\u002Fskills\u002Fywc-wayfinder\u002FSKILL.md",[],[],"2026-11-10 22:39:42",false,"---\nname: ywc-wayfinder\ndescription: >-\n  (ywc) Use when a large or uncertain change needs multi-session discovery with\n  a deterministic local map and exactly one active ticket before planning or\n  implementation. Triggers: \"wayfinder\", \"길찾기\", \"discovery map\", \"multi-session\n  discovery\", \"탐색 ticket\", \"経路整理\", \"探索マップ\", \"ywc-wayfinder\". Do not use\n  for ordinary planning (use ywc-plan), idea clarification (use ywc-brainstorm),\n  direct implementation, or tracker\u002Fdatabase writes outside the local Markdown\n  map.\n---\n\n# ywc-wayfinder\n\n**Announce at start:** \"I'm using the ywc-wayfinder skill to manage a deterministic local discovery map with one active ticket.\"\n\nThis skill manages a local Markdown map for large or uncertain discovery work.\nIt does not implement code, does not write to external trackers, and resolves\nat most one active ticket per session before routing the next step.\n\n## Rationalization Defense\n\n| Excuse | Reality |\n|---|---|\n| \"This looks fuzzy, I'll just start coding and document later\" | Wayfinder exists for fuzzy, multi-session discovery. If uncertainty is still material, coding first hides the unresolved decisions instead of shrinking them. |\n| \"I'll keep two active tickets open so I can explore faster\" | Exactly one active ticket is the contract. Multiple active tickets destroy resume safety and make terminal status ambiguous. |\n| \"The map is only a note, I can rewrite history when resuming\" | The map is the local source of truth. Resume must preserve ticket state, evidence, and next context exactly enough for the next session to continue deterministically. |\n| \"If everything is resolved, I'll still append a summary ticket\" | Terminal maps do not write. When all tickets are resolved, return `DONE` without mutating the map. |\n| \"Deferred or blocked tickets can still be marked done if the route is obvious\" | Deferred or blocked terminal state is `NEEDS_CONTEXT`, not `DONE`. A route idea is not the same as resolved context. |\n| \"This can replace normal planning now that the map exists\" | Wayfinder is for discovery, not ordinary planning. Once the route is clear, hand off to `ywc-plan`, `ywc-tech-research`, or another downstream skill. |\n\n## Workflow\n\n1. **Qualify the request**\n   - Use this skill only when the request is large, uncertain, or likely to span multiple sessions.\n   - If the request is ordinary planning or a single-session design discussion, route to `ywc-plan` or `ywc-brainstorm` instead.\n\n2. **Resolve the map path**\n   - The canonical artifact is `docs\u002Fywc-plans\u002F\u003Cslug>-wayfinder.md`.\n   - If the map does not exist, create it with the canonical fields from [references\u002Fmap-ticket-contract.md](references\u002Fmap-ticket-contract.md).\n   - If the map exists, validate its structure before using it.\n\n3. **Enforce one active ticket**\n   - The map may contain many tickets, but only one may be marked active.\n   - If zero active tickets remain and unresolved work still exists, return `NEEDS_CONTEXT`.\n   - If more than one active ticket exists, return `NEEDS_CONTEXT` without writing.\n\n4. **Work one ticket**\n   - Update only the active ticket's evidence, route, and next-context fields.\n   - Route unresolved implementation work onward; do not implement it here.\n   - If the active ticket is invalid, stale, or contradicts the map state, return `NEEDS_CONTEXT` without writing.\n\n5. **Handle terminal states**\n   - If all tickets are resolved, return `DONE` and do not write the map again.\n   - If the best terminal state is deferred or blocked, return `NEEDS_CONTEXT` and do not write.\n\n6. **Route onward**\n   - Use `ywc-plan` for a clarified implementation plan.\n   - Use `ywc-tech-research` when the ticket is blocked on external technical comparison.\n   - Use `ywc-task-generator` only after a downstream planning\u002Fspec path produces a finalized spec.\n   - When a persisted `ywc-tech-research --output` artifact informs the route, record its project-relative Markdown path in the map so later skills can reuse the same provenance and overwrite contract.\n\n## Output Format\n\n```text\nMap: docs\u002Fywc-plans\u002F\u003Cslug>-wayfinder.md\nTicket: \u003Cticket-id>\nRoute: \u003Cnext skill or stop reason>\nCompletion Status: DONE | NEEDS_CONTEXT\n```\n\n## Validation\n\n- `bash codex\u002Fskills\u002Fywc-skill-author\u002Fscripts\u002Fvalidate-skill.sh codex\u002Fskills\u002Fywc-wayfinder`\n- `bash scripts\u002Frun-codex-skill-contract-evals.sh`\n- `bash scripts\u002Fvalidate.sh`\n\n## Integration\n\n- **Upstream:** Large ambiguous requests, resumed discovery sessions, or downstream skills that need a local discovery handoff.\n- **Downstream:** `ywc-plan`, `ywc-tech-research`, `ywc-spec-ready`, or another planning\u002Fresearch skill once the route is clear.\n- **Never downstream directly to implementation:** Executors and code-generation skills require a clearer contract than a discovery ticket provides.\n","# ywc-wayfinder\n\n**Announce at start:** \"I'm using the ywc-wayfinder skill to manage a deterministic local discovery map with one active ticket.\"\n\nThis skill manages a local Markdown map for large or uncertain discovery work.\nIt does not implement code, does not write to external trackers, and resolves\nat most one active ticket per session before routing the next step.\n\n## Rationalization Defense\n\n| Excuse | Reality |\n|---|---|\n| \"This looks fuzzy, I'll just start coding and document later\" | Wayfinder exists for fuzzy, multi-session discovery. If uncertainty is still material, coding first hides the unresolved decisions instead of shrinking them. |\n| \"I'll keep two active tickets open so I can explore faster\" | Exactly one active ticket is the contract. Multiple active tickets destroy resume safety and make terminal status ambiguous. |\n| \"The map is only a note, I can rewrite history when resuming\" | The map is the local source of truth. Resume must preserve ticket state, evidence, and next context exactly enough for the next session to continue deterministically. |\n| \"If everything is resolved, I'll still append a summary ticket\" | Terminal maps do not write. When all tickets are resolved, return `DONE` without mutating the map. |\n| \"Deferred or blocked tickets can still be marked done if the route is obvious\" | Deferred or blocked terminal state is `NEEDS_CONTEXT`, not `DONE`. A route idea is not the same as resolved context. |\n| \"This can replace normal planning now that the map exists\" | Wayfinder is for discovery, not ordinary planning. Once the route is clear, hand off to `ywc-plan`, `ywc-tech-research`, or another downstream skill. |\n\n## Workflow\n\n1. **Qualify the request**\n   - Use this skill only when the request is large, uncertain, or likely to span multiple sessions.\n   - If the request is ordinary planning or a single-session design discussion, route to `ywc-plan` or `ywc-brainstorm` instead.\n\n2. **Resolve the map path**\n   - The canonical artifact is `docs\u002Fywc-plans\u002F\u003Cslug>-wayfinder.md`.\n   - If the map does not exist, create it with the canonical fields from [references\u002Fmap-ticket-contract.md](references\u002Fmap-ticket-contract.md).\n   - If the map exists, validate its structure before using it.\n\n3. **Enforce one active ticket**\n   - The map may contain many tickets, but only one may be marked active.\n   - If zero active tickets remain and unresolved work still exists, return `NEEDS_CONTEXT`.\n   - If more than one active ticket exists, return `NEEDS_CONTEXT` without writing.\n\n4. **Work one ticket**\n   - Update only the active ticket's evidence, route, and next-context fields.\n   - Route unresolved implementation work onward; do not implement it here.\n   - If the active ticket is invalid, stale, or contradicts the map state, return `NEEDS_CONTEXT` without writing.\n\n5. **Handle terminal states**\n   - If all tickets are resolved, return `DONE` and do not write the map again.\n   - If the best terminal state is deferred or blocked, return `NEEDS_CONTEXT` and do not write.\n\n6. **Route onward**\n   - Use `ywc-plan` for a clarified implementation plan.\n   - Use `ywc-tech-research` when the ticket is blocked on external technical comparison.\n   - Use `ywc-task-generator` only after a downstream planning\u002Fspec path produces a finalized spec.\n   - When a persisted `ywc-tech-research --output` artifact informs the route, record its project-relative Markdown path in the map so later skills can reuse the same provenance and overwrite contract.\n\n## Output Format\n\n```text\nMap: docs\u002Fywc-plans\u002F\u003Cslug>-wayfinder.md\nTicket: \u003Cticket-id>\nRoute: \u003Cnext skill or stop reason>\nCompletion Status: DONE | NEEDS_CONTEXT\n```\n\n## Validation\n\n- `bash codex\u002Fskills\u002Fywc-skill-author\u002Fscripts\u002Fvalidate-skill.sh codex\u002Fskills\u002Fywc-wayfinder`\n- `bash scripts\u002Frun-codex-skill-contract-evals.sh`\n- `bash scripts\u002Fvalidate.sh`\n\n## Integration\n\n- **Upstream:** Large ambiguous requests, resumed discovery sessions, or downstream skills that need a local discovery handoff.\n- **Downstream:** `ywc-plan`, `ywc-tech-research`, `ywc-spec-ready`, or another planning\u002Fresearch skill once the route is clear.\n- **Never downstream directly to implementation:** Executors and code-generation skills require a clearer contract than a discovery ticket provides.\n",{"name":5,"description":7},"main","7e8ac872e53df8c89d75663e031626281a2a2f5c","codex\u002Fskills\u002Fywc-wayfinder",1,"https:\u002F\u002Fgithub.com\u002Fyongwoon\u002Fywc-agent-toolkit","https:\u002F\u002Fgithub.com\u002Fyongwoon","https:\u002F\u002Fwww.webhani.com","2026-11-08 17:14:59",{"source":8,"skillName":5,"commands":32,"prompt":42,"zipAvailable":43},[33,36,39],{"tool":34,"command":35},"npx","npx skills add yongwoon\u002Fywc-agent-toolkit --skill ywc-wayfinder",{"tool":37,"command":38},"bunx","bunx skills add yongwoon\u002Fywc-agent-toolkit --skill ywc-wayfinder",{"tool":40,"command":41},"pnpm","pnpm dlx skills add yongwoon\u002Fywc-agent-toolkit --skill ywc-wayfinder","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fyongwoon\u002Fywc-agent-toolkit\u002Fblob\u002Fmain\u002Fcodex\u002Fskills\u002Fywc-wayfinder\u002FSKILL.md",true,[45,51,55,59,63,66,70,74,78],{"path":46,"resourceType":47,"resourceTypeDesc":48,"sizeBytes":49,"sourceHtmlUrl":50},"agents\u002Fopenai.yaml","REFERENCE","参考文档",300,"https:\u002F\u002Fgithub.com\u002Fyongwoon\u002Fywc-agent-toolkit\u002Fblob\u002Fmain\u002Fcodex\u002Fskills\u002Fywc-wayfinder\u002Fagents\u002Fopenai.yaml",{"path":52,"resourceType":47,"resourceTypeDesc":48,"sizeBytes":53,"sourceHtmlUrl":54},"evals\u002Fevals.json",1246,"https:\u002F\u002Fgithub.com\u002Fyongwoon\u002Fywc-agent-toolkit\u002Fblob\u002Fmain\u002Fcodex\u002Fskills\u002Fywc-wayfinder\u002Fevals\u002Fevals.json",{"path":56,"resourceType":47,"resourceTypeDesc":48,"sizeBytes":57,"sourceHtmlUrl":58},"README.en.md",667,"https:\u002F\u002Fgithub.com\u002Fyongwoon\u002Fywc-agent-toolkit\u002Fblob\u002Fmain\u002Fcodex\u002Fskills\u002Fywc-wayfinder\u002FREADME.en.md",{"path":60,"resourceType":47,"resourceTypeDesc":48,"sizeBytes":61,"sourceHtmlUrl":62},"README.es.md",751,"https:\u002F\u002Fgithub.com\u002Fyongwoon\u002Fywc-agent-toolkit\u002Fblob\u002Fmain\u002Fcodex\u002Fskills\u002Fywc-wayfinder\u002FREADME.es.md",{"path":64,"resourceType":47,"resourceTypeDesc":48,"sizeBytes":61,"sourceHtmlUrl":65},"README.ja.md","https:\u002F\u002Fgithub.com\u002Fyongwoon\u002Fywc-agent-toolkit\u002Fblob\u002Fmain\u002Fcodex\u002Fskills\u002Fywc-wayfinder\u002FREADME.ja.md",{"path":67,"resourceType":47,"resourceTypeDesc":48,"sizeBytes":68,"sourceHtmlUrl":69},"README.ko.md",811,"https:\u002F\u002Fgithub.com\u002Fyongwoon\u002Fywc-agent-toolkit\u002Fblob\u002Fmain\u002Fcodex\u002Fskills\u002Fywc-wayfinder\u002FREADME.ko.md",{"path":71,"resourceType":47,"resourceTypeDesc":48,"sizeBytes":72,"sourceHtmlUrl":73},"README.md",1010,"https:\u002F\u002Fgithub.com\u002Fyongwoon\u002Fywc-agent-toolkit\u002Fblob\u002Fmain\u002Fcodex\u002Fskills\u002Fywc-wayfinder\u002FREADME.md",{"path":75,"resourceType":47,"resourceTypeDesc":48,"sizeBytes":76,"sourceHtmlUrl":77},"README.zh.md",698,"https:\u002F\u002Fgithub.com\u002Fyongwoon\u002Fywc-agent-toolkit\u002Fblob\u002Fmain\u002Fcodex\u002Fskills\u002Fywc-wayfinder\u002FREADME.zh.md",{"path":79,"resourceType":47,"resourceTypeDesc":48,"sizeBytes":80,"sourceHtmlUrl":81},"references\u002Fmap-ticket-contract.md",2056,"https:\u002F\u002Fgithub.com\u002Fyongwoon\u002Fywc-agent-toolkit\u002Fblob\u002Fmain\u002Fcodex\u002Fskills\u002Fywc-wayfinder\u002Freferences\u002Fmap-ticket-contract.md",[83,89,95,102,109,116],{"skillNo":84,"name":85,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":86,"categories":87,"keywords":88,"publishedAt":18},"01M72TQ84GTCPCV2VJ778V17TW","missing-frontmatter","https:\u002F\u002Fgithub.com\u002Fyongwoon\u002Fywc-agent-toolkit\u002Fblob\u002Fmain\u002Fscripts\u002Ffixtures\u002Fcodex-description-limit\u002Fmissing-frontmatter\u002FSKILL.md",[],[],{"skillNo":90,"name":91,"nameZh":6,"description":6,"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":18},"01M72TQ6M4BFWE7P9EPW0GZDCM","malformed-frontmatter","https:\u002F\u002Fgithub.com\u002Fyongwoon\u002Fywc-agent-toolkit\u002Fblob\u002Fmain\u002Fscripts\u002Ffixtures\u002Fcodex-description-limit\u002Fmalformed-frontmatter\u002FSKILL.md",[],[],{"skillNo":96,"name":97,"nameZh":6,"description":98,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":99,"categories":100,"keywords":101,"publishedAt":18},"01M72TQ3ESGKXZ4QRWGTX92BKJ","fixture-501-fail","(ywc) Use when aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa Do not use for x.","https:\u002F\u002Fgithub.com\u002Fyongwoon\u002Fywc-agent-toolkit\u002Fblob\u002Fmain\u002Fscripts\u002Ffixtures\u002Fcodex-description-limit\u002F501-fail\u002FSKILL.md",[],[],{"skillNo":103,"name":104,"nameZh":6,"description":105,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":106,"categories":107,"keywords":108,"publishedAt":18},"01M72TQ0HJ8H3R37J9WPWGKJZR","fixture-500-pass","(ywc) Use when aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa Do not use for x.","https:\u002F\u002Fgithub.com\u002Fyongwoon\u002Fywc-agent-toolkit\u002Fblob\u002Fmain\u002Fscripts\u002Ffixtures\u002Fcodex-description-limit\u002F500-pass\u002FSKILL.md",[],[],{"skillNo":110,"name":111,"nameZh":6,"description":112,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":113,"categories":114,"keywords":115,"publishedAt":18},"01M72TPWNCC7NEYD0D9N12KSQS","ywc-worktrees","(ywc) Use when creating, auditing, pruning, or resolving git worktrees for isolated task workspaces, whether delegated from an executor or used standalone. Triggers: \"worktree 생성\", \"worktree audit\", \"worktree 정리\", \"worktree prune\", \"ywc-worktrees\", \"create worktree\". Do not use for branch creation\u002Fdeletion alone, PR creation (use ywc-create-pr), CI or merge delivery (use ywc-finish-branch), task orchestration (use ywc-sequential-executor or ywc-parallel-executor), or non-git isolation.","https:\u002F\u002Fgithub.com\u002Fyongwoon\u002Fywc-agent-toolkit\u002Fblob\u002Fmain\u002Fplugins\u002Fywc-agent-toolkit\u002Fskills\u002Fywc-worktrees\u002FSKILL.md",[],[],{"skillNo":117,"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":118,"categories":119,"keywords":120,"publishedAt":18},"01M72TPRNR3E6QWB91GM98ABBV","https:\u002F\u002Fgithub.com\u002Fyongwoon\u002Fywc-agent-toolkit\u002Fblob\u002Fmain\u002Fplugins\u002Fywc-agent-toolkit\u002Fskills\u002Fywc-wayfinder\u002FSKILL.md",[],[]]