tlc-spec-driven

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Tech Lead's Club - Spec-Driven Development

技术负责人俱乐部 - Spec-Driven Development

Plan and implement projects with precision. Granular tasks. Clear dependencies. Right tools.

┌──────────┐   ┌──────────┐   ┌─────────┐   ┌───────────────────┐
│ SPECIFY  │ → │  DESIGN  │ → │  TASKS  │ → │ IMPLEMENT+VALIDATE│
└──────────┘   └──────────┘   └─────────┘   └───────────────────┘

精准规划与实施项目。颗粒化任务、清晰依赖关系、适配工具选型。

┌──────────┐   ┌──────────┐   ┌─────────┐   ┌───────────────────┐
│ SPECIFY  │ → │  DESIGN  │ → │  TASKS  │ → │ IMPLEMENT+VALIDATE│
└──────────┘   └──────────┘   └─────────┘   └───────────────────┘

Project Structure

项目结构

.specs/
├── project/
│   ├── PROJECT.md      # Vision & goals
│   ├── ROADMAP.md      # Features & milestones
│   └── STATE.md        # Memory between sessions
├── codebase/           # Brownfield analysis (existing projects)
│   ├── STACK.md
│   ├── ARCHITECTURE.md
│   ├── CONVENTIONS.md
│   ├── STRUCTURE.md
│   ├── TESTING.md
│   └── INTEGRATIONS.md
└── features/           # Feature specifications
    └── [feature]/
        ├── spec.md
        ├── design.md
        └── tasks.md

.specs/
├── project/
│   ├── PROJECT.md      # 愿景与目标
│   ├── ROADMAP.md      # 功能与里程碑
│   └── STATE.md        # 跨会话记忆
├── codebase/           # 遗留系统分析（现有项目）
│   ├── STACK.md
│   ├── ARCHITECTURE.md
│   ├── CONVENTIONS.md
│   ├── STRUCTURE.md
│   ├── TESTING.md
│   └── INTEGRATIONS.md
└── features/           # 功能规格说明
    └── [feature]/
        ├── spec.md
        ├── design.md
        └── tasks.md

Workflow

工作流程

New project:

Initialize project → PROJECT.md
Create roadmap → ROADMAP.md
Specify features → existing workflow

Existing codebase:

Map codebase → 6 brownfield docs
Initialize project → PROJECT.md + ROADMAP.md
Specify features → existing workflow

新项目：

初始化项目 → PROJECT.md
创建路线图 → ROADMAP.md
定义功能需求 → 沿用现有工作流程

现有代码库：

梳理代码库 → 生成6份遗留系统分析文档
初始化项目 → PROJECT.md + ROADMAP.md
定义功能需求 → 沿用现有工作流程

Context Loading Strategy

上下文加载策略

Base load (~15k tokens):

PROJECT.md (if exists)
ROADMAP.md (when planning/working on features)
STATE.md (persistent memory)

On-demand load:

Codebase docs (when working in existing project)
spec.md (when working on specific feature)
design.md (when implementing from design)
tasks.md (when executing tasks)

Never load simultaneously:

Multiple feature specs
Multiple architecture docs
Archived documents

Target: <40k tokens total context Reserve: 160k+ tokens for work, reasoning, outputs Monitoring: Display status when >40k (see context-limits.md)

基础加载（约15k tokens）：

PROJECT.md（若存在）
ROADMAP.md（规划/开发功能时）
STATE.md（持久化记忆）

按需加载：

代码库文档（处理现有项目时）
spec.md（开发特定功能时）
design.md（基于设计实现时）
tasks.md（执行任务时）

禁止同时加载：

多个功能规格文档
多份架构文档
已归档文档

目标： <40k tokens 总上下文 预留： 160k+ tokens 用于工作、推理、输出 监控： 当上下文超过40k时显示状态（详见context-limits.md）

Commands

指令

Project-level:

Trigger Pattern	Reference
Initialize project, setup project	project-init.md
Create roadmap, plan features	roadmap.md
Map codebase, analyze existing code	brownfield-mapping.md
Record decision, log blocker	state-management.md
Pause work, end session	session-handoff.md
Resume work, continue	session-handoff.md

Feature-level:

Trigger Pattern	Reference
Specify feature, define requirements	specify.md
Design feature, architecture	design.md
Break into tasks, create tasks	tasks.md
Implement task, build	implement.md
Validate, verify, test	validate.md

Tools:

Trigger Pattern	Reference
Code analysis, search patterns	code-analysis.md

项目级：

触发模式	参考文档
Initialize project, setup project	project-init.md
Create roadmap, plan features	roadmap.md
Map codebase, analyze existing code	brownfield-mapping.md
Record decision, log blocker	state-management.md
Pause work, end session	session-handoff.md
Resume work, continue	session-handoff.md

功能级：

触发模式	参考文档
Specify feature, define requirements	specify.md
Design feature, architecture	design.md
Break into tasks, create tasks	tasks.md
Implement task, build	implement.md
Validate, verify, test	validate.md

工具类：

触发模式	参考文档
Code analysis, search patterns	code-analysis.md

Output Behavior

输出行为

Model guidance: After completing lightweight tasks (validation, state updates, session handoff), naturally mention once that such tasks work well with faster/cheaper models. Track in STATE.md under

Preferences

to avoid repeating. For heavy tasks (brownfield mapping, complex design), briefly note the reasoning requirements before starting.

Be conversational, not robotic. Don't interrupt workflow—add as a natural closing note. Skip if user seems experienced or has already acknowledged the tip.

模型建议： 完成轻量任务（验证、状态更新、会话交接）后，自然提及一次这类任务更适配更快/更经济的模型。在STATE.md的

Preferences

下记录该偏好，避免重复提示。对于重型任务（遗留系统梳理、复杂设计），在开始前简要说明推理需求。

保持对话式语气，不要生硬刻板。不要打断工作流程——作为自然的结束语添加。若用户看起来经验丰富或已认可该提示，则跳过。

Code Analysis

代码分析

Use available tools with graceful degradation. See code-analysis.md.

使用可用工具并支持优雅降级。详见code-analysis.md。