project-structure

gvarela 的头像作者 gvarela

强制执行docs/plans/目录中的项目文档结构 - research.md用于事实,design.md用于决策,tasks.md用于实施,thoughts/用于探索。

📖 中文导读:强制执行docs/plans/目录中的项目文档结构 - research.md用于事实,design.md用于决策,tasks.md用于实施,thoughts/用于探索。 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。

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/