[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7EKDB5V7H749V6H48XM3GFH":3,"skill-same:01M7EKDB5V7H749V6H48XM3GFH":46},{"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":27,"repositoryHtmlUrl":28,"repositoryHomepageUrl":6,"ownerHtmlUrl":29,"ownerBlogUrl":30,"ownerDescription":6,"updatedAt":31,"install":32,"resources":45},"01M7EKDB5V7H749V6H48XM3GFH","api-change",null,"Change the TURNPool API types safely - edit types and markers, regenerate, update webhooks, tests and docs. Use whenever a field is added, removed or re-marked in api\u002Fv1alpha1.","Hazmi35\u002Fturnfleet","Hazmi35","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F32807631?v=4","01M7EKD5JD8P0491P8RHDSTZSF","hzmi","01M7EKD5K13ED85DGGNKGPX6KM",2,"AGPL-3.0","https:\u002F\u002Fgithub.com\u002FHazmi35\u002Fturnfleet\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fapi-change\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: api-change\ndescription: Change the TURNPool API types safely - edit types and markers, regenerate, update webhooks, tests and docs. Use whenever a field is added, removed or re-marked in api\u002Fv1alpha1.\n---\n\n# Changing the TURNPool API\n\nWork in this order. Each step catches a different class of mistake.\n\n1. **Edit `api\u002Fv1alpha1\u002Fturnpool_types.go`.**\n   - Every field is explicitly `+optional` or `+required`. No floats. Ratios are\n     `portsInUse`\u002F`portsTotal` integers that consumers divide.\n   - Lists get `+listType=map` + `+listMapKey=\u003Ckey>` (or `+listType=atomic` with\n     a one-line reason). Avoid maps.\n   - Status fields are `+optional` and derived from the spec, never cached\n     from it. Conditions stay the first status field, set with\n     `meta.SetStatusCondition`.\n   - New enum values: extend the Go type, the `+kubebuilder:validation:Enum`\n     marker, and every `switch` over it (the `exhaustive` linter fails the\n     build otherwise). Add the doc comment on the new value, and the\n     `AGENTS.md` glossary line for it when the value names a domain concept, in\n     the same edit.\n2. **Decide mutability.** Anything that would invalidate live allocations is\n   immutable: relay port range, addressing mode and its per-node split, realm.\n   Adding it to the immutability check in\n   `internal\u002Fwebhook\u002Fv1alpha1\u002Fturnpool_webhook.go` is part of the change, with\n   the reason in the validation message.\n3. **Regenerate** (`make generate manifests api-docs`). Never hand-edit\n   `zz_generated.deepcopy.go`, `config\u002Fcrd\u002Fbases\u002F*`, `config\u002Frbac\u002Frole.yaml` or\n   `docs\u002Fapi.md`.\n4. **Update the webhooks**: defaulting for anything with a sensible default,\n   validating for the rules the CRD schema cannot express (mode-specific\n   config, listener port uniqueness, ports outside the relay range, overlap\n   between relays sharing an address).\n5. **Update tests**:\n   - `internal\u002Fwebhook\u002Fv1alpha1\u002Fturnpool_webhook_test.go` for defaulting and\n     each rejection (envtest, table-driven).\n   - `internal\u002Frelay` golden files if the rendered coturn config changes; a new\n     field that reaches the data plane always changes the goldens.\n   - `test\u002Fe2e\u002F` if the field is observable from outside.\n6. **Update docs**: `docs\u002Fapi.md` is generated. `docs\u002Farchitecture.md` and\n   `docs\u002Fcapacity-model.md` are not. A new addressing mode also needs an ADR\n   (`add-addressing-mode`).\n7. **Prove it**: `make ci`. If the change touches the data plane,\n   `make test-e2e`.\n\nReport which files changed and which command proved the change.\n","# Changing the TURNPool API\n\nWork in this order. Each step catches a different class of mistake.\n\n1. **Edit `api\u002Fv1alpha1\u002Fturnpool_types.go`.**\n   - Every field is explicitly `+optional` or `+required`. No floats. Ratios are\n     `portsInUse`\u002F`portsTotal` integers that consumers divide.\n   - Lists get `+listType=map` + `+listMapKey=\u003Ckey>` (or `+listType=atomic` with\n     a one-line reason). Avoid maps.\n   - Status fields are `+optional` and derived from the spec, never cached\n     from it. Conditions stay the first status field, set with\n     `meta.SetStatusCondition`.\n   - New enum values: extend the Go type, the `+kubebuilder:validation:Enum`\n     marker, and every `switch` over it (the `exhaustive` linter fails the\n     build otherwise). Add the doc comment on the new value, and the\n     `AGENTS.md` glossary line for it when the value names a domain concept, in\n     the same edit.\n2. **Decide mutability.** Anything that would invalidate live allocations is\n   immutable: relay port range, addressing mode and its per-node split, realm.\n   Adding it to the immutability check in\n   `internal\u002Fwebhook\u002Fv1alpha1\u002Fturnpool_webhook.go` is part of the change, with\n   the reason in the validation message.\n3. **Regenerate** (`make generate manifests api-docs`). Never hand-edit\n   `zz_generated.deepcopy.go`, `config\u002Fcrd\u002Fbases\u002F*`, `config\u002Frbac\u002Frole.yaml` or\n   `docs\u002Fapi.md`.\n4. **Update the webhooks**: defaulting for anything with a sensible default,\n   validating for the rules the CRD schema cannot express (mode-specific\n   config, listener port uniqueness, ports outside the relay range, overlap\n   between relays sharing an address).\n5. **Update tests**:\n   - `internal\u002Fwebhook\u002Fv1alpha1\u002Fturnpool_webhook_test.go` for defaulting and\n     each rejection (envtest, table-driven).\n   - `internal\u002Frelay` golden files if the rendered coturn config changes; a new\n     field that reaches the data plane always changes the goldens.\n   - `test\u002Fe2e\u002F` if the field is observable from outside.\n6. **Update docs**: `docs\u002Fapi.md` is generated. `docs\u002Farchitecture.md` and\n   `docs\u002Fcapacity-model.md` are not. A new addressing mode also needs an ADR\n   (`add-addressing-mode`).\n7. **Prove it**: `make ci`. If the change touches the data plane,\n   `make test-e2e`.\n\nReport which files changed and which command proved the change.\n",{"name":5,"description":7},"main","9544bc3bb9a017f646498013e8462e8269aa3357",".agents\u002Fskills\u002Fapi-change",0,"https:\u002F\u002Fgithub.com\u002FHazmi35\u002Fturnfleet","https:\u002F\u002Fgithub.com\u002FHazmi35","https:\u002F\u002Fhzmi.dev","2026-11-15 05:35:57",{"source":8,"skillName":5,"commands":33,"prompt":43,"zipAvailable":44},[34,37,40],{"tool":35,"command":36},"npx","npx skills add Hazmi35\u002Fturnfleet --skill api-change",{"tool":38,"command":39},"bunx","bunx skills add Hazmi35\u002Fturnfleet --skill api-change",{"tool":41,"command":42},"pnpm","pnpm dlx skills add Hazmi35\u002Fturnfleet --skill api-change","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FHazmi35\u002Fturnfleet\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fapi-change\u002FSKILL.md",true,[],[47,53,59,65,71,77],{"skillNo":48,"name":49,"nameZh":6,"description":6,"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},"01M7EKGEH2RYAK4XSGG6QYMN26","writing-for-agents","https:\u002F\u002Fgithub.com\u002FHazmi35\u002Fturnfleet\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Fwriting-for-agents\u002FSKILL.md",[],[],{"skillNo":54,"name":55,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":56,"categories":57,"keywords":58,"publishedAt":19},"01M7EKGDCRT4TB799978RPTRD9","wayfinder","https:\u002F\u002Fgithub.com\u002FHazmi35\u002Fturnfleet\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Fwayfinder\u002FSKILL.md",[],[],{"skillNo":60,"name":61,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":62,"categories":63,"keywords":64,"publishedAt":19},"01M7EKGC75FKAVQEXYWQQHWYF4","wait-what","https:\u002F\u002Fgithub.com\u002FHazmi35\u002Fturnfleet\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Fwait-what\u002FSKILL.md",[],[],{"skillNo":66,"name":67,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":68,"categories":69,"keywords":70,"publishedAt":19},"01M7EKGANG5441YGY9B8RTE13F","triage","https:\u002F\u002Fgithub.com\u002FHazmi35\u002Fturnfleet\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Ftriage\u002FSKILL.md",[],[],{"skillNo":72,"name":73,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":74,"categories":75,"keywords":76,"publishedAt":19},"01M7EKG7BN7EPEJC1WRGX8WPWD","to-tickets","https:\u002F\u002Fgithub.com\u002FHazmi35\u002Fturnfleet\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Fto-tickets\u002FSKILL.md",[],[],{"skillNo":78,"name":79,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":80,"categories":81,"keywords":82,"publishedAt":19},"01M7EKG67Z1F9BG2JNYAYR32Z2","to-spec","https:\u002F\u002Fgithub.com\u002FHazmi35\u002Fturnfleet\u002Fblob\u002Fmain\u002F.claude\u002Fskills\u002Fto-spec\u002FSKILL.md",[],[]]