[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M75XFASRANQJCPX69X2J1N4R":3,"skill-same:01M75XFASRANQJCPX69X2J1N4R":47},{"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":29,"ownerHtmlUrl":30,"ownerBlogUrl":29,"ownerDescription":31,"updatedAt":32,"install":33,"resources":46},"01M75XFASRANQJCPX69X2J1N4R","project-tech-design",null,"Use when writing or revising a technical design that settles an architecture, an entity model, a module boundary or a subsystem, or when a review comment reopens such a decision.","loupe-ac\u002Floupe","loupe-ac","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F345019842?v=4","01M75XDH3V7GZDHB5M0J04BFTP","Loupe","01M75XDH4EWXVAMQEHFV5TWBMF",2,"AGPL-3.0","https:\u002F\u002Fgithub.com\u002Floupe-ac\u002Floupe\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fproject-tech-design\u002FSKILL.md",[],[],"2026-11-12 13:55:43",false,"---\nname: project-tech-design\ndescription: \"Use when writing or revising a technical design that settles an architecture, an entity model, a module boundary or a subsystem, or when a review comment reopens such a decision.\"\n---\n\n# Technical designs\n\nA technical design settles an architecture. An implementation plan settles tasks. Write the design first.\n\nSend every design to the Loupe app for review. **Invoke `loupe-documents` before you write.** That skill gives the format rules for the review UI. This skill gives the content rules.\n\nFollow `plugins\u002Floupe-lifecycle\u002Fskills\u002Floupe-stage-tech-design\u002Freferences\u002Ftech-document.md` for the design sections, the recommendations and the estimate marks. This skill adds the rules that belong to this project.\n\nWrite the design for a reader who knows the product. The section \"Write for a reader who knows the product\" of `loupe-documents` `references\u002Fdesign-structure.md` gives the rule.\n\nWrite the document in ASD-STE100 Simplified Technical English. The writing rules are in `compressing-skills`.\n\nAn ADR name such as `0001-app-over-worker` never gets a tooltip on the review page. Give it a meaning inline at its first mention in each section. `loupe-documents` rule 16 says the same for an outside ID.\n\n## Verify each claim against the code\n\nRead the code before you state a fact about it. Never write a count from memory.\n\nOne audit design stated five wrong numbers. It claimed 11 security call sites, and the code had 14. It claimed 22 silent handlers, and the code had 27. It claimed one privacy violation, and the code had 26. It also described a renaming workstream that did not exist, because every operation name was already correct.\n\nRun the search. Count the result. Put the number in the document.\n\nSay what you could not verify. Silence reads as confidence.\n\nA claim about a library, an API, a database or speed needs proof too. Read the current docs, or run a proof of concept, as \"Facts and recommendations\" of the stage skill says.\n\n## Separate the trigger from the problem\n\nThe trigger is the event that made you look. The problem is what the code gets wrong.\n\nA lapsed trial blocked an agent. That was the trigger. One status column cannot hold two facts. That was the problem.\n\nWrite both, and keep them apart. A design that fixes the trigger leaves the problem in place.\n\n## Make the change easy, then make the easy change\n\nKent Beck states the rule. Apply it when a small feature does not fit the model.\n\nA comped account had to stack with a Stripe subscription. One status column could not express it. The correct design added subscription records first, and the comp then cost one row.\n\nDifficulty is evidence. When a small change fights the model, the model is the work. Say so in the document, and plan the enabling change as its own step.\n\n## Cover the project's own checks\n\nGive the document a section for the checks the work must satisfy. Gamache, arkitect, and the migration rules all constrain a design.\n\nList the rules that apply, and say what each one forces. A design that ignores them produces a branch that cannot pass `just ci`.\n\nRead the five gamache layers before you claim no rule applies. `project-backend` lists them in `references\u002Fgamache.md`.\n\n## Order the work around live data\n\nA step that touches live data needs its own entry in the work order. Say what breaks if the migration is wrong.\n\n## Take the example case from this project\n\nTake the case of each worked example from this project. A card of the board, a page of the dev seed or a rule of a skill are good cases.\n\n## Common mistakes\n\n| Mistake | Correction |\n|---|---|\n| A count taken from memory | Run the search, then write the number |\n| The trigger described as the problem | Write both, and keep them apart |\n| \"All 107 call sites\" | Verify the scope; 45 of them were diagnostics |\n| A decision fence with two paragraphs above the options | One paragraph converts, two do not |\n| An implementation plan submitted as a design | Settle the architecture first |\n| A decision written in class names | Write it for a reader who knows the product |\n| \"I recommend option 2\", or \"under D1 option 1\", in a decision | Say what the option does, and state the fact inline (`loupe-documents` rule 18) |\n","# Technical designs\n\nA technical design settles an architecture. An implementation plan settles tasks. Write the design first.\n\nSend every design to the Loupe app for review. **Invoke `loupe-documents` before you write.** That skill gives the format rules for the review UI. This skill gives the content rules.\n\nFollow `plugins\u002Floupe-lifecycle\u002Fskills\u002Floupe-stage-tech-design\u002Freferences\u002Ftech-document.md` for the design sections, the recommendations and the estimate marks. This skill adds the rules that belong to this project.\n\nWrite the design for a reader who knows the product. The section \"Write for a reader who knows the product\" of `loupe-documents` `references\u002Fdesign-structure.md` gives the rule.\n\nWrite the document in ASD-STE100 Simplified Technical English. The writing rules are in `compressing-skills`.\n\nAn ADR name such as `0001-app-over-worker` never gets a tooltip on the review page. Give it a meaning inline at its first mention in each section. `loupe-documents` rule 16 says the same for an outside ID.\n\n## Verify each claim against the code\n\nRead the code before you state a fact about it. Never write a count from memory.\n\nOne audit design stated five wrong numbers. It claimed 11 security call sites, and the code had 14. It claimed 22 silent handlers, and the code had 27. It claimed one privacy violation, and the code had 26. It also described a renaming workstream that did not exist, because every operation name was already correct.\n\nRun the search. Count the result. Put the number in the document.\n\nSay what you could not verify. Silence reads as confidence.\n\nA claim about a library, an API, a database or speed needs proof too. Read the current docs, or run a proof of concept, as \"Facts and recommendations\" of the stage skill says.\n\n## Separate the trigger from the problem\n\nThe trigger is the event that made you look. The problem is what the code gets wrong.\n\nA lapsed trial blocked an agent. That was the trigger. One status column cannot hold two facts. That was the problem.\n\nWrite both, and keep them apart. A design that fixes the trigger leaves the problem in place.\n\n## Make the change easy, then make the easy change\n\nKent Beck states the rule. Apply it when a small feature does not fit the model.\n\nA comped account had to stack with a Stripe subscription. One status column could not express it. The correct design added subscription records first, and the comp then cost one row.\n\nDifficulty is evidence. When a small change fights the model, the model is the work. Say so in the document, and plan the enabling change as its own step.\n\n## Cover the project's own checks\n\nGive the document a section for the checks the work must satisfy. Gamache, arkitect, and the migration rules all constrain a design.\n\nList the rules that apply, and say what each one forces. A design that ignores them produces a branch that cannot pass `just ci`.\n\nRead the five gamache layers before you claim no rule applies. `project-backend` lists them in `references\u002Fgamache.md`.\n\n## Order the work around live data\n\nA step that touches live data needs its own entry in the work order. Say what breaks if the migration is wrong.\n\n## Take the example case from this project\n\nTake the case of each worked example from this project. A card of the board, a page of the dev seed or a rule of a skill are good cases.\n\n## Common mistakes\n\n| Mistake | Correction |\n|---|---|\n| A count taken from memory | Run the search, then write the number |\n| The trigger described as the problem | Write both, and keep them apart |\n| \"All 107 call sites\" | Verify the scope; 45 of them were diagnostics |\n| A decision fence with two paragraphs above the options | One paragraph converts, two do not |\n| An implementation plan submitted as a design | Settle the architecture first |\n| A decision written in class names | Write it for a reader who knows the product |\n| \"I recommend option 2\", or \"under D1 option 1\", in a decision | Say what the option does, and state the fact inline (`loupe-documents` rule 18) |\n",{"name":5,"description":7},"main","b0ae29efd5410c4e5bf9a6ed6aed4b6c1d82e55a",".agents\u002Fskills\u002Fproject-tech-design",0,"https:\u002F\u002Fgithub.com\u002Floupe-ac\u002Floupe","https:\u002F\u002Floupe.ac\u002F","https:\u002F\u002Fgithub.com\u002Floupe-ac","The control plane for your agent loops.","2026-11-15 04:50:14",{"source":8,"skillName":5,"commands":34,"prompt":44,"zipAvailable":45},[35,38,41],{"tool":36,"command":37},"npx","npx skills add loupe-ac\u002Floupe --skill project-tech-design",{"tool":39,"command":40},"bunx","bunx skills add loupe-ac\u002Floupe --skill project-tech-design",{"tool":42,"command":43},"pnpm","pnpm dlx skills add loupe-ac\u002Floupe --skill project-tech-design","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Floupe-ac\u002Floupe\u002Fblob\u002Fmain\u002F.agents\u002Fskills\u002Fproject-tech-design\u002FSKILL.md",true,[],[48,55,62,69,76,83],{"skillNo":49,"name":50,"nameZh":6,"description":51,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":52,"categories":53,"keywords":54,"publishedAt":19},"01M75XHSK6MYZ0BH7PJHP378QV","loupe-workers","Use when reading worker runs or bridges through the loupe MCP, stopping, resuming or holding workers, cancelling a bridge command, or recovering workers after a usage limit or network outage.","https:\u002F\u002Fgithub.com\u002Floupe-ac\u002Floupe\u002Fblob\u002Fmain\u002Fplugins\u002Floupe\u002Fskills\u002Floupe-workers\u002FSKILL.md",[],[],{"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},"01M75XHPW77P75PPWY8Z7Q9XMZ","loupe-site-review","Use when acting on live-review feedback through the loupe MCP: reading the feedback of a card or project, fixing it, or marking it addressed.","https:\u002F\u002Fgithub.com\u002Floupe-ac\u002Floupe\u002Fblob\u002Fmain\u002Fplugins\u002Floupe\u002Fskills\u002Floupe-site-review\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},"01M75XHK6EZP2FZRQ1B4PS4CGH","loupe-inbox","Use when an agent needs a decision, answer or review from the project owner through the loupe MCP, hands a question or to-do to a person, resumes after an ask closed, or needs its session id.","https:\u002F\u002Fgithub.com\u002Floupe-ac\u002Floupe\u002Fblob\u002Fmain\u002Fplugins\u002Floupe\u002Fskills\u002Floupe-inbox\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},"01M75XHDN9XG71R4T248BZ540A","loupe-documents","Use when writing or revising a document for the Loupe app through the loupe MCP, such as a plan, spec, RFC, audit report or retrospective.","https:\u002F\u002Fgithub.com\u002Floupe-ac\u002Floupe\u002Fblob\u002Fmain\u002Fplugins\u002Floupe\u002Fskills\u002Floupe-documents\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},"01M75XHBERM2SWJ7SJ1EB5M4SB","loupe-discovery","Use when a bridge runs a discovery run of a Loupe project, when a prompt names loupe-discovery, or when writing a readiness report.","https:\u002F\u002Fgithub.com\u002Floupe-ac\u002Floupe\u002Fblob\u002Fmain\u002Fplugins\u002Floupe\u002Fskills\u002Floupe-discovery\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},"01M75XH7X2KCFWPVMQJJAMPYJN","loupe-board","Use when working a Loupe project board through the loupe MCP: reading or writing a card, moving a card, changing the columns, or linking a document or a pull request to a card.","https:\u002F\u002Fgithub.com\u002Floupe-ac\u002Floupe\u002Fblob\u002Fmain\u002Fplugins\u002Floupe\u002Fskills\u002Floupe-board\u002FSKILL.md",[],[]]