@chongyan/autospec 1.0.1 → 1.0.2

package/knowledge/README.en.md

@@ -0,0 +1,372 @@
+# AutoSpec Knowledge Layer
+
+> **Version**: v5.0
+> **Last Updated**: 2026-03-27
+> **Changes**: Comprehensive restructuring - All directories added numeric prefixes, files sorted by priority, unified verb-based naming
+
+This directory contains AutoSpec's core knowledge files, which are copied to the user project's `.autospec/knowledge/` directory during `autospec init`.
+
+## Directory Structure
+
+```
+knowledge/
+├── 00-README.md              # This file (Knowledge Layer Navigation)
+│
+├── 01-principles/            # Principles Layer — 🔴 Frozen Zone (Constitution-level)
+│   ├── README.md             # Principles Overview + Quick Reference Navigation
+│   ├── 00-principles-hierarchy.md  # General Principles Framework (L1→L2→L3→L4 full traceability)
+│   ├── 01-first-principles.md      # L1 First Principles (P1-P3 Prism)
+│   ├── 02-strategic-principles.md  # L2 Strategic Principles (S1-S4)
+│   ├── 03-tactical-principles.md   # L3 Tactical Principles (T1-T6)
+│   ├── 04-operational-principles.md # L4 Operational Principles (O1-O4)
+│   ├── 05-domain-principles.md     # Domain Practice Principles (DDD/Systems/Requirement/Code/CR/Knowledge Management)
+│   ├── 06-methodology-principles.md # Methodology Principles (P1-P44)
+│   ├── 07-cognitive-principles.md  # Cognitive Enhancement Principles (CP1-CP10)
+│   ├── 08-auto-fix-principles.md   # Auto-Fix Principles (Lessons from Practice)
+│   ├── 09-constitution.md          # Project Constitution (15 Red Lines)
+│   └── 10-evolution-mechanism.md   # Self-Evolution Mechanism (Three-Layer Evolution System)
+│
+├── 02-process/               # Process Layer — 🟡 Controlled Zone (6-Stage Execution Flow)
+│   ├── README.md             # Process Layer Navigation
+│   ├── 00-overview.md        # Process Overview (Startup Gateway + Execution Modes)
+│   ├── 01-requirement.md     # Requirement Analysis Stage
+│   ├── 02-design.md          # Solution Design Stage
+│   ├── 03-implementation.md  # Coding Implementation Stage
+│   ├── 04-review.md          # Code Review Stage
+│   ├── 05-testing.md         # QA Testing Stage
+│   └── 06-delivery.md        # Delivery & Deployment Stage
+│
+├── 03-guides/                # Capability Guides — 🟡/🟢 Controlled/Free Zone (51 Skill Files)
+│   # Core Protocols (00-01)
+│   ├── 00-pipeline-protocol.md      # Pipeline Protocol
+│   ├── 01-team-orchestrator.md      # Team Orchestrator
+│   # Stage Execution (02-08)
+│   ├── 02-analyze-requirement.md    # Requirement Analysis
+│   ├── 03-design-solution.md        # Solution Design
+│   ├── 04-implement-code.md         # Coding Implementation
+│   ├── 05-plan-testing.md           # Testing Plan
+│   ├── 06-generate-tests.md         # Test Generation
+│   ├── 07-check-release.md          # Release Check
+│   ├── 08-evaluate-ai-effect.md     # AI Effect Evaluation
+│   # Review Skills (09-14)
+│   ├── 09-review-requirement.md     # Requirement Review
+│   ├── 10-review-design.md          # Design Review
+│   ├── 11-review-code.md            # Code Review
+│   ├── 12-review-testing.md         # Testing Review
+│   ├── 13-audit-security.md         # Security Audit
+│   ├── 14-check-consistency.md      # Consistency Check
+│   # Testing Execution (15-17)
+│   ├── 15-run-unit-tests.md         # Unit Testing
+│   ├── 16-run-integration-tests.md  # Integration Testing
+│   ├── 17-analyze-test-context.md   # Test Context Analysis
+│   # Evolution Support (18-22)
+│   ├── 18-log-practice.md           # Practice Logging
+│   ├── 19-distill-skill.md          # Skill Distillation
+│   ├── 20-update-skill.md           # Skill Update
+│   ├── 21-validate-skill.md         # Skill Validation
+│   ├── 22-extract-methodology.md    # Methodology Extraction
+│   # Context/Environment (23-29)
+│   ├── 23-infer-scope.md            # Scope Inference
+│   ├── 24-assess-complexity.md      # Complexity Assessment
+│   ├── 25-discover-component.md     # Component Discovery
+│   ├── 26-analyze-tech-stack.md     # Tech Stack Analysis
+│   ├── 27-scan-environment.md       # Environment Scanning
+│   ├── 28-validate-environment.md   # Environment Validation
+│   ├── 29-generate-knowledge.md     # Knowledge Generation
+│   # AI Specialized (30-41)
+│   ├── 30-analyze-ai-capability.md  # AI Capability Analysis
+│   ├── 31-analyze-ai-component.md   # AI Component Analysis
+│   ├── 32-analyze-ai-agent.md       # AI Agent Analysis
+│   ├── 33-analyze-ai-rag.md         # AI RAG Analysis
+│   ├── 34-assess-ai-task.md         # AI Task Assessment
+│   ├── 35-evaluate-ai-pipeline.md   # AI Pipeline Evaluation
+│   ├── 36-evaluate-ai-artifact.md   # AI Artifact Evaluation
+│   ├── 37-plan-ai-evaluation.md     # AI Evaluation Plan
+│   ├── 38-evaluate-ai-path.md       # AI Path Assessment
+│   ├── 39-validate-ai-data.md       # AI Data Validation
+│   ├── 40-detect-ai-anomaly.md      # AI Anomaly Detection
+│   ├── 41-diagnose-ai-test.md       # AI Test Diagnosis
+│   # Domain Methodology (42-44)
+│   ├── 42-apply-ddd.md              # DDD Application
+│   ├── 43-run-ai-sdlc.md            # AI-SDLC Execution
+│   ├── 44-manage-knowledge.md       # Knowledge Management
+│   # Tool Skills (45)
+│   └── 45-test-runner.md            # Test Runner
+│   # Files merged into templates (deleted)
+│   # ├── 51-build-glossary.md → 09-templates/05-business-glossary.md
+│   # ├── 52-define-domain-rules.md → 09-templates/06-business-rules.md
+│   # ├── 53-engineer-requirement.md → 09-templates/00-requirement-proposal.md
+│   # ├── 54-design-system.md → 09-templates/01-architecture-design.md
+│   # ├── 56-draw-flow-chart.md → 09-templates/07-business-flows.md
+│
+├── 04-checklists/            # Checklists — 🟡 Controlled Zone (Stage Check Items)
+│   ├── README.md             # Checklists Navigation
+│   ├── 00-requirement.md     # Requirement Checklist
+│   ├── 01-design.md          # Design Checklist
+│   ├── 02-code.md            # Coding Checklist
+│   ├── 03-test.md            # Testing Checklist
+│   └── 04-release.md         # Release Checklist
+│
+├── 05-config/                # Configuration Files — 🟡 Controlled Zone (Validation Patterns + Team Config)
+│   ├── README.md             # Configuration Directory Navigation
+│   ├── 00-validation-patterns.yaml  # Validation Patterns Configuration
+│   ├── 01-team-stage.yaml           # Team Stage Configuration (with triggers)
+│   ├── 02-team-tasks.yaml           # Team Tasks Configuration
+│   ├── 03-role-composition.yaml     # Role Composition Configuration (with decision tree)
+│   ├── 04-role-extensions.yaml      # Role Extensions Configuration
+│   └── 05-skill-compositions.yaml   # Skill Compositions Configuration
+│
+├── 06-environment/           # Environment Knowledge — 🔵 Environment Knowledge Zone (Middleware/Components/Integration)
+│   ├── README.md             # Environment Bridging Protocol
+│   ├── 00-template-registry.md      # Template Registry
+│   └── 01-detection-patterns.yaml   # Detection Patterns
+│
+├── 07-standards/             # Standards & Norms — 🟡 Controlled Zone (Coding/Review/Data Consistency)
+│   ├── README.md             # Standards Navigation
+│   ├── 00-coding-style.md    # Coding Style Standards
+│   ├── 01-code-review.md     # Code Review Standards
+│   ├── 02-data-consistency.md # Data Consistency Standards
+│   ├── 03-document-versioning.md # Document Versioning Standards
+│   └── 04-risk-detection.md  # Risk Detection Standards
+│
+├── 08-organization/          # Organization Knowledge — 🟢 Free Zone (Vision/Culture/Governance)
+│   ├── README.md             # Organization Layer Navigation
+│   ├── 00-vision-mission.md  # Vision, Mission, Core Values
+│   ├── 01-ai-native-culture.md # AI Native Team Culture Handbook
+│   ├── 02-team-metrics.md    # Team Metrics System
+│   ├── 03-committee-structure.md # Governance Committee Structure
+│   ├── 04-governance-metrics.md # Governance Monitoring Metrics
+│   └── 05-improvement-process.md # Improvement Process
+│
+└── 09-templates/             # Document Templates — 🟡 Controlled Zone (Standardized Templates)
+    ├── README.md             # Template Navigation
+    ├── 00-requirement-proposal.md # Requirement Proposal Template
+    ├── 01-architecture-design.md  # Architecture Design Template
+    ├── 02-api-design.md           # API Design Template
+    ├── 03-database-design.md      # Database Design Template
+    ├── 04-product-design.md       # Product Design Template
+    ├── 05-business-glossary.md    # Business Glossary Template
+    ├── 06-business-rules.md       # Business Rules Template
+    ├── 07-business-flows.md       # Business Flows Template
+    ├── 08-test-design.md          # Test Design Template
+    ├── 09-evaluation-design.md    # Evaluation Design (AI/Model)
+    ├── 10-component-knowledge.md  # Component Knowledge Template
+    ├── 11-best-practices.md       # Best Practices Template
+    └── 12-domain-model.md         # Domain Model Template
+```
+
+## Core Files Overview
+
+### 01-principles/ — Principles Layer (Constitution-level)
+
+| File | Description | Evolution Zone |
+|------|------|---------|
+| [01-principles/README.md](01-principles/README.md) | Principles Overview + Quick Reference Navigation | 🔴 Frozen Zone |
+| [01-principles/00-principles-hierarchy.md](01-principles/00-principles-hierarchy.md) | General Principles Framework (L1→L2→L3→L4) | 🔴 Frozen Zone |
+| [01-principles/01-first-principles.md](01-principles/01-first-principles.md) | L1 First Principles (P1-P3 Prism) | 🔴 Frozen Zone |
+| [01-principles/02-strategic-principles.md](01-principles/02-strategic-principles.md) | L2 Strategic Principles (S1-S4) | 🔴 Frozen Zone |
+| [01-principles/03-tactical-principles.md](01-principles/03-tactical-principles.md) | L3 Tactical Principles (T1-T6) | 🟡 Controlled Zone |
+| [01-principles/04-operational-principles.md](01-principles/04-operational-principles.md) | L4 Operational Principles (O1-O4) | 🟡 Controlled Zone |
+| [01-principles/05-domain-principles.md](01-principles/05-domain-principles.md) | Domain Practice Principles (DDP/SDP/REP/CEP/CRP/KMP) | 🟡 Controlled Zone |
+| [01-principles/06-methodology-principles.md](01-principles/06-methodology-principles.md) | Methodology Principles (P1-P44) | 🟡 Controlled Zone |
+| [01-principles/07-cognitive-principles.md](01-principles/07-cognitive-principles.md) | Cognitive Enhancement Principles (CP1-CP10) | 🟡 Controlled Zone |
+| [01-principles/08-auto-fix-principles.md](01-principles/08-auto-fix-principles.md) | Auto-Fix Principles (AFP1-AFP6) | 🟡 Controlled Zone |
+| [01-principles/09-constitution.md](01-principles/09-constitution.md) | Project Constitution (15 Red Lines) | 🔴 Frozen Zone |
+| [01-principles/10-evolution-mechanism.md](01-principles/10-evolution-mechanism.md) | Self-Evolution Mechanism (Three-Layer Evolution System) | 🔴 Frozen Zone |
+
+### 02-process/ — Process Layer
+
+| File | Description | Evolution Zone |
+|------|------|---------|
+| [02-process/README.md](02-process/README.md) | Process Layer Navigation | 🟡 Controlled Zone |
+| [02-process/00-overview.md](02-process/00-overview.md) | Process Overview, Startup Gateway, Execution Modes | 🟡 Controlled Zone |
+| [02-process/01-requirement.md](02-process/01-requirement.md) | Requirement Analysis Stage | 🟡 Controlled Zone |
+| [02-process/02-design.md](02-process/02-design.md) | Solution Design Stage | 🟡 Controlled Zone |
+| [02-process/03-implementation.md](02-process/03-implementation.md) | Coding Implementation Stage | 🟡 Controlled Zone |
+| [02-process/04-review.md](02-process/04-review.md) | Code Review Stage | 🟡 Controlled Zone |
+| [02-process/05-testing.md](02-process/05-testing.md) | QA Testing Stage | 🟡 Controlled Zone |
+| [02-process/06-delivery.md](02-process/06-delivery.md) | Delivery & Deployment Stage | 🟡 Controlled Zone |
+
+### 03-guides/ — Capability Guides
+
+| Category | Number Range | Files | Evolution Zone |
+|----------|--------------|-------|----------------|
+| Core Protocols | 00-01 | 2 | 🔴 Frozen Zone |
+| Stage Execution | 02-08 | 7 | 🟡 Controlled Zone |
+| Review Skills | 09-14 | 6 | 🟡 Controlled Zone |
+| Testing Execution | 15-17 | 3 | 🟡 Controlled Zone |
+| Evolution Support | 18-22 | 5 | 🟢 Free Zone |
+| Context/Environment | 23-29 | 7 | 🟡 Controlled Zone |
+| AI Specialized | 30-41 | 12 | 🟡 Controlled Zone |
+| Domain Methodology | 50-57 | 8 | 🟡 Controlled Zone |
+| Others | 99 | 1 | 🟢 Free Zone |
+
+Complete file list: [03-guides/](03-guides/)
+
+### 04-checklists/ — Checklists
+
+| File | Description | Evolution Zone |
+|------|------|---------|
+| [04-checklists/README.md](04-checklists/README.md) | Checklists Navigation | 🟡 Controlled Zone |
+| [04-checklists/00-requirement.md](04-checklists/00-requirement.md) | Requirement Checklist | 🟡 Controlled Zone |
+| [04-checklists/01-design.md](04-checklists/01-design.md) | Design Checklist | 🟡 Controlled Zone |
+| [04-checklists/02-code.md](04-checklists/02-code.md) | Coding Checklist | 🟡 Controlled Zone |
+| [04-checklists/03-test.md](04-checklists/03-test.md) | Testing Checklist | 🟡 Controlled Zone |
+| [04-checklists/04-release.md](04-checklists/04-release.md) | Release Checklist | 🟡 Controlled Zone |
+
+### 05-config/ — Configuration Files
+
+| File | Description | Evolution Zone |
+|------|------|---------|
+| [05-config/README.md](05-config/README.md) | Configuration Directory Navigation | 🟡 Controlled Zone |
+| [05-config/00-validation-patterns.yaml](05-config/00-validation-patterns.yaml) | Validation Patterns Configuration | 🟡 Controlled Zone |
+| [05-config/01-team-stage.yaml](05-config/01-team-stage.yaml) | Team Stage Configuration (with triggers) | 🟡 Controlled Zone |
+| [05-config/02-team-tasks.yaml](05-config/02-team-tasks.yaml) | Team Tasks Configuration | 🟡 Controlled Zone |
+| [05-config/03-role-composition.yaml](05-config/03-role-composition.yaml) | Role Composition Configuration (with decision tree) | 🟡 Controlled Zone |
+| [05-config/04-role-extensions.yaml](05-config/04-role-extensions.yaml) | Role Extensions Configuration | 🟡 Controlled Zone |
+| [05-config/05-skill-compositions.yaml](05-config/05-skill-compositions.yaml) | Skill Compositions Configuration | 🟡 Controlled Zone |
+
+### 06-environment/ — Environment Knowledge
+
+| File | Description | Evolution Zone |
+|------|------|---------|
+| [06-environment/README.md](06-environment/README.md) | Environment Bridging Protocol | 🔵 Environment Knowledge Zone |
+| [06-environment/00-template-registry.md](06-environment/00-template-registry.md) | Template Registry | 🔵 Environment Knowledge Zone |
+| [06-environment/01-detection-patterns.yaml](06-environment/01-detection-patterns.yaml) | Detection Patterns | 🔵 Environment Knowledge Zone |
+
+### 09-templates/ — Document Templates
+
+| File | Description | Evolution Zone |
+|------|------|---------|
+| [09-templates/README.md](09-templates/README.md) | Templates Directory Navigation | 🟡 Controlled Zone |
+| [09-templates/13-middleware-knowledge.md](09-templates/13-middleware-knowledge.md) | Middleware Knowledge Template | 🔵 Environment Knowledge Zone |
+| [09-templates/10-component-knowledge.md](09-templates/10-component-knowledge.md) | Component Knowledge Template | 🔵 Environment Knowledge Zone |
+
+### 07-standards/ — Standards & Norms
+
+| File | Description | Evolution Zone |
+|------|------|---------|
+| [07-standards/README.md](07-standards/README.md) | Standards Navigation | 🟡 Controlled Zone |
+| [07-standards/00-coding-style.md](07-standards/00-coding-style.md) | Coding Style Standards | 🟡 Controlled Zone |
+| [07-standards/01-code-review.md](07-standards/01-code-review.md) | Code Review Standards | 🟡 Controlled Zone |
+| [07-standards/02-data-consistency.md](07-standards/02-data-consistency.md) | Data Consistency Standards | 🟡 Controlled Zone |
+| [07-standards/03-document-versioning.md](07-standards/03-document-versioning.md) | Document Versioning Standards | 🟡 Controlled Zone |
+| [07-standards/04-risk-detection.md](07-standards/04-risk-detection.md) | Risk Detection Standards | 🟡 Controlled Zone |
+
+### 08-organization/ — Organization Layer
+
+| File | Description | Evolution Zone |
+|------|------|---------|
+| [08-organization/README.md](08-organization/README.md) | Organization Layer Navigation | 🟢 Free Zone |
+| [08-organization/00-vision-mission.md](08-organization/00-vision-mission.md) | Vision, Mission, Core Values | 🟡 Controlled Zone |
+| [08-organization/01-ai-native-culture.md](08-organization/01-ai-native-culture.md) | AI Native Team Culture Handbook | 🟢 Free Zone |
+| [08-organization/02-team-metrics.md](08-organization/02-team-metrics.md) | Team Metrics System | 🟢 Free Zone |
+| [08-organization/03-committee-structure.md](08-organization/03-committee-structure.md) | Governance Committee Structure | 🟢 Free Zone |
+| [08-organization/04-governance-metrics.md](08-organization/04-governance-metrics.md) | Governance Monitoring Metrics | 🟢 Free Zone |
+| [08-organization/05-improvement-process.md](08-organization/05-improvement-process.md) | Improvement Process | 🟢 Free Zone |
+
+### 09-templates/ — Document Templates
+
+| File | Description | Evolution Zone |
+|------|------|---------|
+| [09-templates/README.md](09-templates/README.md) | Template Navigation | 🟡 Controlled Zone |
+| [09-templates/01-architecture-design.md](09-templates/01-architecture-design.md) | Architecture Design Template | 🟡 Controlled Zone |
+| [09-templates/02-api-design.md](09-templates/02-api-design.md) | API Design Template | 🟡 Controlled Zone |
+| [09-templates/03-database-design.md](09-templates/03-database-design.md) | Database Design Template | 🟡 Controlled Zone |
+| [09-templates/04-product-design.md](09-templates/04-product-design.md) | Product Design Template | 🟡 Controlled Zone |
+| [09-templates/05-business-glossary.md](09-templates/05-business-glossary.md) | Business Glossary Template | 🟡 Controlled Zone |
+| [09-templates/06-business-rules.md](09-templates/06-business-rules.md) | Business Rules Template | 🟡 Controlled Zone |
+| [09-templates/07-business-flows.md](09-templates/07-business-flows.md) | Business Flows Template | 🟡 Controlled Zone |
+| [09-templates/08-test-design.md](09-templates/08-test-design.md) | Test Design Template | 🟡 Controlled Zone |
+| [09-templates/09-evaluation-design.md](09-templates/09-evaluation-design.md) | Evaluation Design (AI/Model) | 🟡 Controlled Zone |
+| [09-templates/10-component-knowledge.md](09-templates/10-component-knowledge.md) | Component Knowledge Template | 🟡 Controlled Zone |
+| [09-templates/11-best-practices.md](09-templates/11-best-practices.md) | Best Practices Template | 🟡 Controlled Zone |
+| [09-templates/12-domain-model.md](09-templates/12-domain-model.md) | Domain Model Template | 🟡 Controlled Zone |
+
+## Three-Layer Self-Evolution System
+
+| Layer | Command | Goal | Location |
+|-------|---------|------|----------|
+| L1: Self-Evolve | `/self-evolve` | Framework iteration & upgrade | `.claude/commands/self-evolve.md` |
+| L2: Field-Evolve | `/autospec:field-evolve` | Learning from practice projects | `plugins/commands/field-evolve.md` |
+| L3: Project-Evolve | `/autospec:project-evolve` | Practice project self-optimization | `plugins/commands/project-evolve.md` |
+
+**Benchmark-Driven Evolution**: Practice Flow → Benchmarks Evaluation → Field-Evolve Analysis → Distill Universal Templates → Update Framework Capabilities
+
+## Quick Navigation
+
+### Find Documents by Scenario
+
+| Scenario | Documentation |
+|----------|---------------|
+| **Understanding Principles** | [01-principles/README.md](01-principles/README.md) - Principles Overview |
+| **Principles Traceability** | [01-principles/00-principles-hierarchy.md](01-principles/00-principles-hierarchy.md) - L1→L2→L3→L4 Full Traceability |
+| **Starting New Task** | [02-process/00-overview.md](02-process/00-overview.md) - Startup Gateway |
+| **Requirement Analysis** | [02-process/01-requirement.md](02-process/01-requirement.md) + [04-checklists/00-requirement.md](04-checklists/00-requirement.md) |
+| **Solution Design** | [02-process/02-design.md](02-process/02-design.md) + [04-checklists/01-design.md](04-checklists/01-design.md) |
+| **Coding Implementation** | [02-process/03-implementation.md](02-process/03-implementation.md) + [07-standards/00-coding-style.md](07-standards/00-coding-style.md) |
+| **Code Review** | [02-process/04-review.md](02-process/04-review.md) + [07-standards/01-code-review.md](07-standards/01-code-review.md) |
+| **Testing** | [02-process/05-testing.md](02-process/05-testing.md) + [04-checklists/03-test.md](04-checklists/03-test.md) |
+| **Delivery & Deployment** | [02-process/06-delivery.md](02-process/06-delivery.md) + [04-checklists/04-release.md](04-checklists/04-release.md) |
+| **Encountering Errors** | [01-principles/08-auto-fix-principles.md](01-principles/08-auto-fix-principles.md) + [01-principles/09-constitution.md](01-principles/09-constitution.md) |
+| **Framework Evolution** | [01-principles/10-evolution-mechanism.md](01-principles/10-evolution-mechanism.md) |
+| **Domain-Driven Design** | [03-guides/42-apply-ddd.md](03-guides/42-apply-ddd.md) |
+
+### Principles Quick Reference
+
+Complete principles quick reference table and traceability chain:
+- [Principles Overview](01-principles/README.md#principles-quick-reference)
+- [General Principles Framework](01-principles/00-principles-hierarchy.md)
+- [L1 First Principles](01-principles/01-first-principles.md)
+- [L2 Strategic Principles](01-principles/02-strategic-principles.md)
+- [L3 Tactical Principles](01-principles/03-tactical-principles.md)
+- [L4 Operational Principles](01-principles/04-operational-principles.md)
+
+## Design Principles
+
+The Knowledge Layer follows these design principles:
+
+1. **Self-Contained**: Knowledge files are independent of `scripts/` code, can be copied to user projects independently
+2. **Extensible**: Enterprise overlay layer supports organizational customization
+3. **Evolvable**: Three-layer self-evolution system (L1 Self-Evolve → L2 Field-Evolve → L3 Project-Evolve) enables continuous improvement
+4. **Human-Machine Separation**: `guides/domain-*.md` files store human-maintained business knowledge
+5. **Benchmark-Driven**: Quantify evolution effects through Benchmarks evaluation, ensuring improvements are evidence-based
+6. **Unified Principles Layer**: All principles documents are stored in `01-principles/` directory for easy reference and traceability
+7. **Numeric Priority**: All directories and files have numeric prefixes (01-09) for quick location
+
+## Usage
+
+```bash
+# Initialize project (copy Knowledge Layer to .autospec/knowledge/)
+autospec init
+
+# Update Knowledge Layer (preserves runtime state)
+autospec update
+```
+
+## Runtime Directories
+
+The following directories are automatically generated at runtime:
+
+- `evaluation/` - Benchmark Cases (automatically archived from success/failure cases)
+- `evolution/` - Evolution Records (practice-log, improvement proposals, etc.)
+- `environment/` - Environment Knowledge (auto-detected and generated)
+
+## Change History
+
+| Version | Date | Changes |
+|---------|------|---------|
+| v5.0 | 2026-03-27 | Comprehensive restructuring - All directories added numeric prefixes, files sorted by priority, unified verb-based naming |
+| v4.0 | 2026-03-27 | Organization directory restructuring - Added vision/mission files, unified numeric prefixes |
+| v3.0 | 2026-03-27 | Principles system integration - Unified principles directory, removed strategy/tactics separation |
+| v2.0 | 2026-03-27 | Principles layer restructuring - Split principles into strategy and tactics layers |
+| v1.0 | 2026-03-26 | Initial version - Unified principles directory for all principles documents |
+
+---
+
+**Maintainer**: AutoSpec Team
+**Feedback Channel**: Knowledge Base Git Repository Issues
+**Related Documentation**:
+- [Principles Layer](01-principles/README.md)
+- [Process Layer](02-process/README.md)
+- [Organization Layer](08-organization/README.md)