ai-agent-framework-design-guide

Writes and reviews Chinese-first AI agent framework design documents with layered architecture guidance.

1|Updated May 15, 2026
One-click install
npx skills add https://github.com/c2kaka/fancy-skills --skill ai-agent-framework-design-guide-c2kaka
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: ai-agent-framework-design-guide
Source: https://github.com/c2kaka/fancy-skills/tree/main/skills/ai-agent-framework-design-guide
Command: npx skills add https://github.com/c2kaka/fancy-skills --skill ai-agent-framework-design-guide-c2kaka

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Turning scattered code, notes, and partial ideas about an AI agent system into a coherent, reviewable framework design document is hard. This Skill guides the analysis of existing agent systems and produces structured Chinese-first design or design-review documents with clear boundaries, flows, and rollout plans. ## Core Features & Use Cases - Current-State Reconstruction: Rebuilds the existing architecture from source artifacts before proposing target designs, separating facts from proposals and open questions. - Structured Document Outlines: Provides ready-to-use outlines for design proposals and review guides covering goals, architecture, interfaces, call flows, lifecycle rules, safety, observability, and staged rollout. - Reusable Design Patterns: Includes patterns for Planner/Router/Runtime separation, skill categorization, server-authoritative execution, context injection, and contract-stabilized rollout. - Use Case: Given a codebase with mixed routing and runtime logic, use this Skill to produce a formal design document that defines each layer's ownership, end-to-end call paths, lifecycle and idempotency rules, and a P0/P1/P2 rollout plan. ## Quick Start Ask the agent to analyze the current AI agent system and write a Chinese-first framework design document covering architecture boundaries, call flows, lifecycle rules, and rollout phases.

Frequently Asked Questions about ai-agent-framework-design-guide

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I write an AI agent framework design document?▼

Start by reconstructing the current system from source artifacts, then define design goals, scope boundaries, and terminology. Follow the provided outline covering architecture, interfaces, call flows, lifecycle rules, safety, observability, and a staged rollout path.

How to review an agent architecture design proposal?▼

Use the design review guide structure: state review questions, required evidence, and open decisions separately from the design summary. Check boundary clarity, flow completeness, contract precision, safety and fallback behavior, and rollout quality with the included checklist.

What is the difference between Planner, Router, and Runtime layers?▼

The Planner decides whether a request enters a structured path, the Router chooses the execution entry, and the Runtime enriches an already chosen path with context. The skill's example patterns explain how to document these boundaries without overlap.

Can this skill write design documents in languages other than Chinese?▼

The skill defaults to Chinese-first writing with English terms in parentheses on first mention. The language can be adjusted if the task explicitly requires otherwise, but the methodology and outlines remain the same.

When should I not use a full framework design outline?▼

For small tasks like adding a single design note, compress the outline by merging configuration, call logic, and capability sections. Keep core sections on current-state evidence, boundaries, flows, and rollout unless the request is intentionally narrow.