[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7DH1TXEYPMY64T4FTHD0G9M":3,"skill-same:01M7DH1TXEYPMY64T4FTHD0G9M":54},{"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":25,"commitSha":26,"skillDirectory":27,"forksCount":28,"repositoryHtmlUrl":29,"repositoryHomepageUrl":30,"ownerHtmlUrl":31,"ownerBlogUrl":32,"ownerDescription":33,"updatedAt":34,"install":35,"resources":47},"01M7DH1TXEYPMY64T4FTHD0G9M","redesigning-from-first-principles",null,"Redesigns an existing design as if a new requirement had been a founding assumption, then propagates it to every reference and delivers it in working increments. Use when the user explicitly asks to redesign for a requirement or from first principles. Never infer from a feature request. Not for redoing an attempt; use redoing-implementations.","bostonaholic\u002Fskills","bostonaholic","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F362146?v=4","01M7DGVW4NA3AZAS7ZVN59FFTR","Matthew Boston","01M7DGVW56TS63D9MTAPRW8SCT",2,"MIT","https:\u002F\u002Fgithub.com\u002Fbostonaholic\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fengineering\u002Fredesigning-from-first-principles\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: redesigning-from-first-principles\ndescription: Redesigns an existing design as if a new requirement had been a founding assumption, then propagates it to every reference and delivers it in working increments. Use when the user explicitly asks to redesign for a requirement or from first principles. Never infer from a feature request. Not for redoing an attempt; use redoing-implementations.\ndisable-model-invocation: true\n---\n\n# Redesign From First Principles\n\nDo not bolt the new requirement onto the current design. Redesign as if it\nhad been a founding assumption, so the result reads as if it was always\nbuilt that way.\n\n1. **Read the whole design.** Read every file the requirement touches and\n   the files that depend on them, until you can state the current design's\n   assumptions. Name the assumption the requirement breaks.\n2. **Design from scratch.** Ask: if this were written today with the\n   requirement known from day one, what would be built? Describe that target\n   design, then the bolt-on alternative, and say what the bolt-on would leave\n   behind (special cases, flags, adapters, names that no longer fit). If the\n   target design is the current design plus a small addition, say so and make\n   that change; never redesign for its own sake.\n3. **Plan the increments.** Break the path to the target into steps that\n   each leave the system working and its checks passing. Order them so no\n   step needs a later one.\n4. **Get approval.** Reply with the broken assumption, the target design,\n   what the bolt-on would leave behind, and the increments. Wait for\n   approval before editing.\n5. **Deliver one increment at a time.** After each, run the project's\n   checks and fix until they pass before starting the next.\n6. **Propagate to every reference.** Search for the broken assumption by\n   name and by idea: types, names, comments, docs, examples, tests,\n   fixtures, config, and rationale or decision sections. Update each to the\n   new design, so none still describes the old one. Report what you changed\n   and any reference you left, with why.\n","# Redesign From First Principles\n\nDo not bolt the new requirement onto the current design. Redesign as if it\nhad been a founding assumption, so the result reads as if it was always\nbuilt that way.\n\n1. **Read the whole design.** Read every file the requirement touches and\n   the files that depend on them, until you can state the current design's\n   assumptions. Name the assumption the requirement breaks.\n2. **Design from scratch.** Ask: if this were written today with the\n   requirement known from day one, what would be built? Describe that target\n   design, then the bolt-on alternative, and say what the bolt-on would leave\n   behind (special cases, flags, adapters, names that no longer fit). If the\n   target design is the current design plus a small addition, say so and make\n   that change; never redesign for its own sake.\n3. **Plan the increments.** Break the path to the target into steps that\n   each leave the system working and its checks passing. Order them so no\n   step needs a later one.\n4. **Get approval.** Reply with the broken assumption, the target design,\n   what the bolt-on would leave behind, and the increments. Wait for\n   approval before editing.\n5. **Deliver one increment at a time.** After each, run the project's\n   checks and fix until they pass before starting the next.\n6. **Propagate to every reference.** Search for the broken assumption by\n   name and by idea: types, names, comments, docs, examples, tests,\n   fixtures, config, and rationale or decision sections. Update each to the\n   new design, so none still describes the old one. Report what you changed\n   and any reference you left, with why.\n",{"name":5,"description":7,"disable-model-invocation":24},true,"main","e8ff85fe8cec970c537bf34f0373fdff02834815","skills\u002Fengineering\u002Fredesigning-from-first-principles",0,"https:\u002F\u002Fgithub.com\u002Fbostonaholic\u002Fskills","https:\u002F\u002Fskills.bostonaholic.dev","https:\u002F\u002Fgithub.com\u002Fbostonaholic","https:\u002F\u002Fmatthewboston.com","agility. simplicity. value.","2026-11-15 04:51:36",{"source":8,"skillName":5,"commands":36,"prompt":46,"zipAvailable":24},[37,40,43],{"tool":38,"command":39},"npx","npx skills add bostonaholic\u002Fskills --skill redesigning-from-first-principles",{"tool":41,"command":42},"bunx","bunx skills add bostonaholic\u002Fskills --skill redesigning-from-first-principles",{"tool":44,"command":45},"pnpm","pnpm dlx skills add bostonaholic\u002Fskills --skill redesigning-from-first-principles","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fbostonaholic\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fengineering\u002Fredesigning-from-first-principles\u002FSKILL.md",[48],{"path":49,"resourceType":50,"resourceTypeDesc":51,"sizeBytes":52,"sourceHtmlUrl":53},"agents\u002Fopenai.yaml","REFERENCE","参考文档",327,"https:\u002F\u002Fgithub.com\u002Fbostonaholic\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fengineering\u002Fredesigning-from-first-principles\u002Fagents\u002Fopenai.yaml",[55,62,69,76,83,90],{"skillNo":56,"name":57,"nameZh":6,"description":58,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":59,"categories":60,"keywords":61,"publishedAt":19},"01M7DH74HXXCFEZVAGZWETR4TY","writing-system-prompts","Writes and reviews system prompts for AI tools, agents, chatbots, and LLM products using a fixed section order and a quality checklist. Use when the user says \"write a system prompt\", or when drafting a system prompt or auditing one for missing stop criteria, tool rules, constraints, or examples. Not for compressing an existing prompt; use improving-prompts.","https:\u002F\u002Fgithub.com\u002Fbostonaholic\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fproductivity\u002Fwriting-system-prompts\u002FSKILL.md",[],[],{"skillNo":63,"name":64,"nameZh":6,"description":65,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":66,"categories":67,"keywords":68,"publishedAt":19},"01M7DH6ZJ1RFRCGM01CGMJ10RY","writing-prose","Writes and edits prose for people in a plain, conversational, short house style with no em dashes. Use when the user says \"write this up\", or when drafting or revising documentation, READMEs, explanations, blog posts, or other human-facing prose. Not for prompts written for agents; use writing-system-prompts or composing-agent-prompts.","https:\u002F\u002Fgithub.com\u002Fbostonaholic\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fproductivity\u002Fwriting-prose\u002FSKILL.md",[],[],{"skillNo":70,"name":71,"nameZh":6,"description":72,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":73,"categories":74,"keywords":75,"publishedAt":19},"01M7DH6TR43CYKY8VHFQWKNDWW","writing-acceptance-criteria","Writes or rewrites acceptance criteria until each is provable: one observable outcome with a named check that can fail. Use when the user says \"write acceptance criteria\", or asks to write, rewrite, or tighten acceptance criteria or a definition of done. Not for proving work meets them; use proving-claims.","https:\u002F\u002Fgithub.com\u002Fbostonaholic\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fproductivity\u002Fwriting-acceptance-criteria\u002FSKILL.md",[],[],{"skillNo":77,"name":78,"nameZh":6,"description":79,"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},"01M7DH6P0PC857A3W7CAGJPXSM","summarizing-shipped-work","Summarizes the user's merged GitHub PRs for a timeframe into a grouped, linked shipped-work report with highlights, and offers to update a brag document. Use when the user says \"what shipped?\", or when asked what the user shipped (this week, last month, a quarter, since a date), for a status update, or to update a brag doc.","https:\u002F\u002Fgithub.com\u002Fbostonaholic\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fproductivity\u002Fsummarizing-shipped-work\u002FSKILL.md",[],[],{"skillNo":84,"name":85,"nameZh":6,"description":86,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":87,"categories":88,"keywords":89,"publishedAt":19},"01M7DH6H3YCJ59CZ0DMKHZ3N7S","running-retros","Mines a session transcript, past agent sessions, or named sources such as PR review comments for durable learnings, then proposes approval-gated edits to skills, AGENTS.md, or docs and tracker issues. Use when the user says \"retro\", or when the user explicitly asks for a retrospective. Never infer from session end or friction.","https:\u002F\u002Fgithub.com\u002Fbostonaholic\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fproductivity\u002Frunning-retros\u002FSKILL.md",[],[],{"skillNo":91,"name":92,"nameZh":6,"description":93,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":94,"categories":95,"keywords":96,"publishedAt":19},"01M7DH6C68WZB8Z6DD4MH770B7","learning-from-mistakes","Codifies the latest correction or mistake in the conversation as a short imperative rule in the project or global CLAUDE.md or AGENTS.md, after the user approves it. Use when the user says \"learn from this mistake\", or when the user asks to learn from a mistake, remember a lesson for next time, add a rule to CLAUDE.md, or not repeat a behavior. Not for a whole session; use running-retros.","https:\u002F\u002Fgithub.com\u002Fbostonaholic\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fproductivity\u002Flearning-from-mistakes\u002FSKILL.md",[],[]]