AgentSkillsCN

project-structure

在 docs/plans/ 目录中强制执行项目文档结构——facts.md 用于事实，design.md 用于决策，tasks.md 用于实施，thoughts/ 用于探索。

SKILL.md
--- frontmatter
name: project-structure
description: Enforces project documentation structure in docs/plans/ directories - research.md for facts, design.md for decisions, tasks.md for implementation, thoughts/ for explorations.

Project Structure

Document Separation

research.md - Facts only (internal codebase + external research)

  • •WHAT EXISTS: Current code, external patterns, options, capabilities
  • •NO decisions, NO rationale, NO implementation steps

design.md - Decisions + rationale only

  • •WHAT to build, WHY chosen
  • •Architectural decisions, trade-offs, scope
  • •NO facts without decisions, NO implementation steps

tasks.md - Implementation only

  • •HOW to implement: specific steps, file changes, tests
  • •NO rationale, NO alternatives

thoughts/ - Explorations & refinements

  • •Questions, experiments, discussions
  • •Understanding refinements before decisions
  • •Informal notes, brainstorming
  • •Anything not ready for formal docs

Quick Check

  • •Decision? → design.md
  • •Fact/Option? → research.md
  • •Step/Code? → tasks.md
  • •Exploring/Unsure? → thoughts/