القائمة
Design APIs/interfaces with Design It Twice: create alternatives, compare tradeoffs, choose one. Use when designing an API, module, class, or boundary.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
Bootstrap AI-ready governance, traceability, cascade, catalog audits, and validation. Use when setting up AI SDLC; aliases: init-ai-repo and ai-sdlc-init.
Extract and save a DDD glossary, flag ambiguities, and propose canonical terms. Use when defining domain language or a shared vocabulary.
Explain broader code or product context around a focused area. Use when the user needs a higher-level perspective before local changes.
Interview the user to stress-test a plan or design until decisions are clear. Use when the user wants to be grilled or challenge a plan.
Stress-test a plan against repo docs and update decisions inline. Use when challenging a design against documented language, ADRs, or CONTEXT.md.
Find deepening opportunities from CONTEXT.md and ADRs. Use when refactoring shallow modules, boundaries, coupling, or testability.
استنادا إلى تصنيف SOC المهني
| name | design-an-api-or-interface |
| description | Design APIs/interfaces with Design It Twice: create alternatives, compare tradeoffs, choose one. Use when designing an API, module, class, or boundary. |
Before generating designs, understand:
Spawn 3+ sub-agents with different constraints:
| Agent | Constraint |
|---|---|
| A | Minimize method count — leanest possible |
| B | Maximize flexibility — most general-purpose |
| C | Optimize for common case — prioritize frequent ops |
| D | Ports & adapters pattern for cross-boundary deps |
Each produces: interface signature, usage examples, internal complexity, trade-offs.
Show: interface signature, usage code, hidden complexity, key trade-offs.
Evaluate on: simplicity, flexibility, implementation efficiency, depth, ease of use vs misuse.
Combine insights. Often best design borrows from multiple options.
Based on "A Philosophy of Software Design" by John Ousterhout — "Design It Twice" principle.
