[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M78FD01ZH2YCNATMPHBT5TRA":3,"skill-same:01M78FD01ZH2YCNATMPHBT5TRA":75},{"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":31,"updatedAt":32,"install":33,"resources":46},"01M78FD01ZH2YCNATMPHBT5TRA","architecture-quality",null,"Dependency direction, cycle detection, boundary leakage, transport\u002Fdomain coupling, god modules, shared mutable state, hidden globals, unstable interfaces","poppyTM\u002Foride","poppyTM","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F339400917?v=4","01M78F6YNKFR5S5JQR27X9F09Z","Poppy Team","01M78F6YP8ZZTRES9X8Q2ZAD21",1,"MIT","https:\u002F\u002Fgithub.com\u002FpoppyTM\u002Foride\u002Fblob\u002Fmain\u002F.ai\u002Fskills\u002Farchitecture-quality\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: architecture-quality\ndescription: Dependency direction, cycle detection, boundary leakage, transport\u002Fdomain coupling, god modules, shared mutable state, hidden globals, unstable interfaces\n---\n# Architecture Quality\n\n## 1. Dependency Direction\nDependencies must point inwards toward higher-level policies. The domain layer should not depend on infrastructure or UI layers. This Dependency Inversion Principle ensures that core business logic remains isolated from volatile implementation details.\n\n## 2. Cycle Detection\nCyclic dependencies create a single tightly coupled super-module. Detect and break dependency cycles using Dependency Inversion, extracting common abstractions, or merging modules if they fundamentally represent the same concept. Use static analysis tools to prevent cycles.\n\n## 3. Boundary Leakage\nEnsure that domain models do not leak into transport or persistence layers, and vice versa. Use DTOs (Data Transfer Objects) and mappers at system boundaries. A change in the database schema should not necessitate a change in the core domain logic.\n\n## 4. Transport\u002FDomain Coupling\nDecouple HTTP\u002FgRPC handlers from domain services. The transport layer is responsible for decoding requests and encoding responses, nothing else. The domain layer should be completely unaware of the transport mechanism used to invoke it.\n\n## 5. God Modules Mitigation\nIdentify and decompose God Modules—classes or packages that know too much or do too much. Break them apart along business capability lines. Establish clear, narrow interfaces for the resulting smaller modules to interact with each other.\n\n## 6. Shared Mutable State\nAvoid shared mutable state across architectural boundaries. When components must share data, prefer message passing, event sourcing, or immutable shared memory. If shared mutable state is unavoidable, encapsulate it strictly behind a synchronizing boundary.\n\n## 7. Hidden Globals Management\nIdentify and eliminate Hidden Globals (e.g., Singletons that maintain state, implicit context objects). They make unit testing difficult and introduce hidden coupling. Replace them with explicit dependency injection and scoped contexts.\n\n## 8. Unstable Interfaces\nIdentify interfaces that change frequently and stabilize them. Apply the Stable Dependencies Principle: depend in the direction of stability. Isolate unstable, experimental modules behind stable adapter layers to protect the rest of the system.\n\n## 9. Architectural Fitness Functions\nImplement automated architectural fitness functions using tools like ArchUnit. Assert that specific packages do not depend on forbidden packages. Fail the build if architectural constraints (e.g., layer isolation) are violated.\n\n## 10. System Observability Hooks\nDesign the architecture to be inherently observable. Embed correlation IDs at the system edges and propagate them through all internal boundaries. Define clear, consistent logging contexts and tracing spans at every architectural transition point.\n\n","# Architecture Quality\n\n## 1. Dependency Direction\nDependencies must point inwards toward higher-level policies. The domain layer should not depend on infrastructure or UI layers. This Dependency Inversion Principle ensures that core business logic remains isolated from volatile implementation details.\n\n## 2. Cycle Detection\nCyclic dependencies create a single tightly coupled super-module. Detect and break dependency cycles using Dependency Inversion, extracting common abstractions, or merging modules if they fundamentally represent the same concept. Use static analysis tools to prevent cycles.\n\n## 3. Boundary Leakage\nEnsure that domain models do not leak into transport or persistence layers, and vice versa. Use DTOs (Data Transfer Objects) and mappers at system boundaries. A change in the database schema should not necessitate a change in the core domain logic.\n\n## 4. Transport\u002FDomain Coupling\nDecouple HTTP\u002FgRPC handlers from domain services. The transport layer is responsible for decoding requests and encoding responses, nothing else. The domain layer should be completely unaware of the transport mechanism used to invoke it.\n\n## 5. God Modules Mitigation\nIdentify and decompose God Modules—classes or packages that know too much or do too much. Break them apart along business capability lines. Establish clear, narrow interfaces for the resulting smaller modules to interact with each other.\n\n## 6. Shared Mutable State\nAvoid shared mutable state across architectural boundaries. When components must share data, prefer message passing, event sourcing, or immutable shared memory. If shared mutable state is unavoidable, encapsulate it strictly behind a synchronizing boundary.\n\n## 7. Hidden Globals Management\nIdentify and eliminate Hidden Globals (e.g., Singletons that maintain state, implicit context objects). They make unit testing difficult and introduce hidden coupling. Replace them with explicit dependency injection and scoped contexts.\n\n## 8. Unstable Interfaces\nIdentify interfaces that change frequently and stabilize them. Apply the Stable Dependencies Principle: depend in the direction of stability. Isolate unstable, experimental modules behind stable adapter layers to protect the rest of the system.\n\n## 9. Architectural Fitness Functions\nImplement automated architectural fitness functions using tools like ArchUnit. Assert that specific packages do not depend on forbidden packages. Fail the build if architectural constraints (e.g., layer isolation) are violated.\n\n## 10. System Observability Hooks\nDesign the architecture to be inherently observable. Embed correlation IDs at the system edges and propagate them through all internal boundaries. Define clear, consistent logging contexts and tracing spans at every architectural transition point.\n\n",{"name":5,"description":7},"main","1cd515630b8ceb57777d466bee4970fe7c2e30e0",".ai\u002Fskills\u002Farchitecture-quality",0,"https:\u002F\u002Fgithub.com\u002FpoppyTM\u002Foride","https:\u002F\u002Fgithub.com\u002FpoppyTM","https:\u002F\u002Fpoppy.lat","Construímos linguagens de programação e ferramentas para quem lê código com o mesmo cuidado com que escreve.","2026-09-30 10:15:52",{"source":8,"skillName":5,"commands":34,"prompt":44,"zipAvailable":45},[35,38,41],{"tool":36,"command":37},"npx","npx skills add poppyTM\u002Foride --skill architecture-quality",{"tool":39,"command":40},"bunx","bunx skills add poppyTM\u002Foride --skill architecture-quality",{"tool":42,"command":43},"pnpm","pnpm dlx skills add poppyTM\u002Foride --skill architecture-quality","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FpoppyTM\u002Foride\u002Fblob\u002Fmain\u002F.ai\u002Fskills\u002Farchitecture-quality\u002FSKILL.md",true,[47,53,57,61,65,71],{"path":48,"resourceType":49,"resourceTypeDesc":50,"sizeBytes":51,"sourceHtmlUrl":52},"checks\u002Farchitecture-checklist.md","REFERENCE","参考文档",313,"https:\u002F\u002Fgithub.com\u002FpoppyTM\u002Foride\u002Fblob\u002Fmain\u002F.ai\u002Fskills\u002Farchitecture-quality\u002Fchecks\u002Farchitecture-checklist.md",{"path":54,"resourceType":49,"resourceTypeDesc":50,"sizeBytes":55,"sourceHtmlUrl":56},"examples\u002Fports_and_adapters.md",1455,"https:\u002F\u002Fgithub.com\u002FpoppyTM\u002Foride\u002Fblob\u002Fmain\u002F.ai\u002Fskills\u002Farchitecture-quality\u002Fexamples\u002Fports_and_adapters.md",{"path":58,"resourceType":49,"resourceTypeDesc":50,"sizeBytes":59,"sourceHtmlUrl":60},"manifest.json",1201,"https:\u002F\u002Fgithub.com\u002FpoppyTM\u002Foride\u002Fblob\u002Fmain\u002F.ai\u002Fskills\u002Farchitecture-quality\u002Fmanifest.json",{"path":62,"resourceType":49,"resourceTypeDesc":50,"sizeBytes":63,"sourceHtmlUrl":64},"references\u002Fclean-architecture.md",1588,"https:\u002F\u002Fgithub.com\u002FpoppyTM\u002Foride\u002Fblob\u002Fmain\u002F.ai\u002Fskills\u002Farchitecture-quality\u002Freferences\u002Fclean-architecture.md",{"path":66,"resourceType":67,"resourceTypeDesc":68,"sizeBytes":69,"sourceHtmlUrl":70},"scripts\u002Fdetect_layer_violations.sh","SCRIPT","脚本",404,"https:\u002F\u002Fgithub.com\u002FpoppyTM\u002Foride\u002Fblob\u002Fmain\u002F.ai\u002Fskills\u002Farchitecture-quality\u002Fscripts\u002Fdetect_layer_violations.sh",{"path":72,"resourceType":49,"resourceTypeDesc":50,"sizeBytes":73,"sourceHtmlUrl":74},"templates\u002Farchitecture-quality-template.md",847,"https:\u002F\u002Fgithub.com\u002FpoppyTM\u002Foride\u002Fblob\u002Fmain\u002F.ai\u002Fskills\u002Farchitecture-quality\u002Ftemplates\u002Farchitecture-quality-template.md",[76,82,88,95,102,109],{"skillNo":77,"name":78,"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":79,"categories":80,"keywords":81,"publishedAt":19},"01M78FHQN254KEH0DETXT5JM29","zoom-reflow","https:\u002F\u002Fgithub.com\u002FpoppyTM\u002Foride\u002Fblob\u002Fmain\u002F.ai\u002Fskills\u002Fzoom-reflow\u002FSKILL.md",[],[],{"skillNo":83,"name":84,"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":85,"categories":86,"keywords":87,"publishedAt":19},"01M78FHP1880S695V8GQEE0RXK","wireframe-styleguide","https:\u002F\u002Fgithub.com\u002FpoppyTM\u002Foride\u002Fblob\u002Fmain\u002F.ai\u002Fskills\u002Fwireframe-styleguide\u002FSKILL.md",[],[],{"skillNo":89,"name":90,"nameZh":6,"description":91,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":92,"categories":93,"keywords":94,"publishedAt":19},"01M78FHHYM6AN2H819FABW01DZ","visual-regression","Pixel-by-pixel snapshot testing, Playwright integration, dynamic content masking, deterministic font rendering, and cross-browser CI gates","https:\u002F\u002Fgithub.com\u002FpoppyTM\u002Foride\u002Fblob\u002Fmain\u002F.ai\u002Fskills\u002Fvisual-regression\u002FSKILL.md",[],[],{"skillNo":96,"name":97,"nameZh":6,"description":98,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":99,"categories":100,"keywords":101,"publishedAt":19},"01M78FHE53D8DD0QVRY5C37DA4","ui-implementation","Component-driven UI implementation, multi-state matrix (default, hover, focus-visible, active, disabled, loading, empty, error), DTCG design tokens, responsive layout contracts, and accessibility tree mapping.","https:\u002F\u002Fgithub.com\u002FpoppyTM\u002Foride\u002Fblob\u002Fmain\u002F.ai\u002Fskills\u002Fui-implementation\u002FSKILL.md",[],[],{"skillNo":103,"name":104,"nameZh":6,"description":105,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":106,"categories":107,"keywords":108,"publishedAt":19},"01M78FHBJ1KXFF734GFE509TBJ","tui-editor-engine","Text buffer and editing semantics for a terminal code editor — index conversion, transaction-first editing, multi-cursor invariants, undo grouping, and large-file behaviour.","https:\u002F\u002Fgithub.com\u002FpoppyTM\u002Foride\u002Fblob\u002Fmain\u002F.ai\u002Fskills\u002Ftui-editor-engine\u002FSKILL.md",[],[],{"skillNo":110,"name":111,"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":112,"categories":113,"keywords":114,"publishedAt":19},"01M78FH9X6CPJX1H61ZDWTTVW8","tree-sitter-context-indexing","https:\u002F\u002Fgithub.com\u002FpoppyTM\u002Foride\u002Fblob\u002Fmain\u002F.ai\u002Fskills\u002Ftree-sitter-context-indexing\u002FSKILL.md",[],[]]