@chongyan/autospec 1.0.2 → 1.0.4

package/knowledge/01-principles/README.en.md

@@ -1,385 +0,0 @@
-# AutoSpec Principles System
-
-> **Purpose**: The framework's "principle operating system" — all execution decisions must trace back to principles in this document
->
-> **Evolution Zone**: 🔴 Frozen Zone (Constitution, Evolution Rules, Core Principles, Design Philosophy)
-
----
-
-## Principles System Overview
-
-```
-┌─────────────────────────────────────────────────────────────┐
-│  L1: First Principles — Inviolable "Laws of Physics"         │
-│  ─────────────────────────────────────────────────────────  │
-│  Verification-First | Minimal-Viable | Progressive-Autonomy  │
-│  → Located at: 01-first-principles.md                         │
-└─────────────────────────────────────────────────────────────┘
-                              │ Deduction
-┌─────────────────────────────────────────────────────────────┐
-│  L2: Strategic Principles — Directional Guidance             │
-│  ─────────────────────────────────────────────────────────  │
-│  Two-Layer Validation | Do-Review Separation | Harness Eng.  │
-│  → Located at: 02-strategic-principles.md                     │
-└─────────────────────────────────────────────────────────────┘
-                              │ Expansion
-┌─────────────────────────────────────────────────────────────┐
-│  L3: Tactical Principles — Execution Strategy Guidance       │
-│  ─────────────────────────────────────────────────────────  │
-│  Task Breakdown | Context Management | Precision Rollback    │
-│  → Located at: 03-tactical-principles.md                      │
-└─────────────────────────────────────────────────────────────┘
-                              │ Implementation
-┌─────────────────────────────────────────────────────────────┐
-│  L4: Operational Principles — Concrete Behavior Standards    │
-│  ─────────────────────────────────────────────────────────  │
-│  Coding Style | Auto-Fix | Constitution Gate | Checklists   │
-│  → Located at: 04-operational-principles.md                   │
-└─────────────────────────────────────────────────────────────┘
-```
-
----
-
-## Directory Structure
-
-```
-principles/
-├── README.md                         # This file (Principles Navigation)
-├── 00-principles-hierarchy.md        # Principles Hierarchy (L1→L2→L3→L4 Traceability)
-├── 01-first-principles.md            # L1 First Principles (P1-P3 Triangular 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/System/Requirement/Coding/CR/KM)
-├── 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 (Extracted from Practice)
-├── 09-constitution.md                # Project Constitution (15 Red Lines, Stop on Violation)
-└── 10-evolution-mechanism.md         # Three-Layer Evolution Mechanism
-```
-
----
-
-## Core Principle Documents
-
-### 00-principles-hierarchy.md — Principles Hierarchy
-
-**Content**: Complete L1→L2→L3→L4 traceability chain, principle application matrix, quick reference table
-
-**Core Chapters**:
-- Principles System Overview (L1→L2→L3→L4)
-- Principle Traceability Chain
-- Principle Application Matrix (by Stage / by Error Type)
-- Principle Quick Reference Table
-- Evolution Zone Description
-
-**Location**: [00-principles-hierarchy.md](00-principles-hierarchy.md)
-
-### 01-first-principles.md — L1 First Principles
-
-**Content**: AutoSpec's "Laws of Physics" — all upper-level principles are deduced from here
-
-**Core Chapters**:
-- P1 Verification-First
-- P2 Minimal-Viable Process
-- P3 Progressive Autonomy
-- Core Design Patterns (Two-Step Generation, Progressive Disclosure, Do-Review Separation, Harness Engineering)
-
-**Location**: [01-first-principles.md](01-first-principles.md)
-
-### 02-strategic-principles.md — L2 Strategic Principles
-
-**Content**: Directional guidance principles deduced from First Principles
-
-**Core Chapters**:
-- S1 Two-Layer Validation
-- S2 Do-Review Separation (Evaluator-Optimizer Separation)
-- S3 Harness Engineering Trilogy
-- S4 Informed Guessing
-
-**Location**: [02-strategic-principles.md](02-strategic-principles.md)
-
-### 03-tactical-principles.md — L3 Tactical Principles
-
-**Content**: Execution strategy guidance principles expanded from Strategic Principles
-
-**Core Chapters**:
-- T1 Task Breakdown Quality (ATOMIC Principles)
-- T2 Context Precision Management
-- T3 Precision Rollback
-- T4 Anti-Pattern Inoculation
-- T5 Taming Non-Determinism
-- T6 Prioritize Reusing Project Capabilities
-
-**Location**: [03-tactical-principles.md](03-tactical-principles.md)
-
-### 04-operational-principles.md — L4 Operational Principles
-
-**Content**: Concrete implementation of Tactical Principles, including specific behavior standards and checklists
-
-**Core Chapters**:
-- O1 Coding Style
-- O2 Auto-Fix Mechanism (Auto-Fix Loop)
-- O3 Constitution Gate
-- O4 Checklists
-
-**Location**: [04-operational-principles.md](04-operational-principles.md)
-
-### 05-domain-principles.md — Domain Practice Principles
-
-**Content**: General principles extracted from domain practices, guiding execution decisions in specific domains
-
-**Core Chapters**:
-- DDP1-4: DDD Tactical Design Principles
-- SDP1-3: System Design Principles
-- REP1-4: Requirement Engineering Principles
-- CEP1-6: Coding Practice Principles
-- CRP1-5: Code Review Principles
-- KMP1-4: Knowledge Management Principles
-
-**Location**: [05-domain-principles.md](05-domain-principles.md)
-
-### 06-methodology-principles.md — Methodology Principles
-
-**Content**: General principles extracted from knowledge and practice (P1-P44)
-
-**Core Chapters**:
-- Thinking Principles (P1-P6, P30-P31)
-- Design Principles (P7-P13, P32-P34)
-- Product & Requirement Principles (P14-P18)
-- Engineering & Quality Principles (P19-P21)
-- Governance & Evolution Principles (P22-P29)
-- Architecture Implementation Principles (P35-P44)
-
-**Location**: [06-methodology-principles.md](06-methodology-principles.md)
-
-### 07-cognitive-principles.md — Cognitive Enhancement Principles
-
-**Content**: Enhancing AI's cognitive intelligence level in the automated development process (CP1-CP10)
-
-**Core Chapters**:
-- Collaboration Stance (CP1 Partner Mode, CP2 Context Matching)
-- Cognitive Discipline (CP3 Ask Before Act, CP4 Complete Logic Chain, CP5 Confidence Labeling)
-- Error & Learning (CP6 Error as Signal, CP7 Pattern Recognition)
-- Deviation Detection (CP8 Three-Level Deviation Alerts)
-- Output Quality (CP9 Just Enough, CP10 Self-Check)
-
-**Location**: [07-cognitive-principles.md](07-cognitive-principles.md)
-
-### 08-auto-fix-principles.md — Auto-Fix Principles
-
-**Content**: Principles extracted from auto-fix mechanism practice
-
-**Core Chapters**:
-- Core Insights (3 items)
-- Principles System (AFP1-AFP6)
-- Principle Application Matrix
-- Principle Checklist
-
-**Location**: [08-auto-fix-principles.md](08-auto-fix-principles.md)
-
-### 09-constitution.md — Project Constitution
-
-**Content**: Red line checklist — violating any item immediately stops the entire process
-
-**Core Chapters**:
-- Safety Red Lines (#1-#3)
-- Process Red Lines (#4-#9)
-- Decision Red Lines (#10-#11)
-- Stop Conditions
-- Auto-Fix Mechanism
-
-**Location**: [09-constitution.md](09-constitution.md)
-
-### 10-evolution-mechanism.md — Self-Evolution Mechanism
-
-**Content**: Three-layer self-evolution system, complete closed loop from project practice to framework upgrade
-
-**Core Chapters**:
-- L1: Self-Evolve (Framework Self-Evolution)
-- L2: Field-Evolve (Domain Evolution)
-- L3: Project-Evolve (Project Self-Evolution)
-- Evolution Zones (Frozen / Controlled / Free)
-- Safety Guardrails
-
-**Location**: [10-evolution-mechanism.md](10-evolution-mechanism.md)
-
----
-
-## Quick Navigation
-
-### Find Principles by Scenario
-
-| Scenario | Applicable Principles | Location |
-|----------|----------------------|----------|
-| **Error needs fix** | Auto-Fix Principles, Fix Loop Principles | [08-auto-fix-principles.md](08-auto-fix-principles.md) |
-| **Coding Implementation** | Coding Style, SOLID Principles, CEP Series | [04-operational-principles.md](04-operational-principles.md#ii-o1-coding-style) |
-| **Code Review** | Review Standards, Checklists, CRP Series | [05-domain-principles.md](05-domain-principles.md#v-code-review-principles) |
-| **Task Breakdown** | ATOMIC Principles, Task Breakdown Quality | [03-tactical-principles.md](03-tactical-principles.md#ii-t1-task-breakdown-quality-atomic-principles) |
-| **Requirement Analysis** | Structured Clarification Protocol, Requirement Layering, REP Series | [05-domain-principles.md](05-domain-principles.md#iii-requirement-engineering-principles) |
-| **Solution Design** | DDD, System Design, DDP/SDP Series | [05-domain-principles.md](05-domain-principles.md#i-ddd-tactical-design-principles) |
-| **Safety Red Lines** | Constitution Gate, Stop Conditions | [09-constitution.md](09-constitution.md) |
-| **Framework Evolution** | Three-Layer Evolution System | [10-evolution-mechanism.md](10-evolution-mechanism.md) |
-
-### Principle Quick Reference
-
-#### L1: First Principles (3 items)
-
-| Principle | One-Liner | Application Scenario |
-|-----------|-----------|---------------------|
-| P1 Verification-First | Deterministic Verification > AI Review > AI Self-Review | All output validation |
-| P2 Minimal-Viable Process | If one file suffices, don't split into two | Knowledge management, task breakdown |
-| P3 Progressive Autonomy | From "human reviews every step" to "human only manages harness" | Autonomous decision boundaries |
-
-#### L2: Strategic Principles (4 items)
-
-| Principle | One-Liner | Application Scenario |
-|-----------|-----------|---------------------|
-| S1 Two-Layer Validation | Layer 1 must pass before Layer 2 | Before completing any stage |
-| S2 Do-Review Separation | Producer and reviewer are different AI instances | When starting review tasks |
-| S3 Harness Engineering | When unsatisfied with output, change the harness | When output quality is poor |
-| S4 Informed Guessing | Maximum 3 NEEDS CLARIFICATION items | Requirement ambiguity handling |
-
-#### L3: Tactical Principles (6 items)
-
-| Principle | One-Liner | Application Scenario |
-|-----------|-----------|---------------------|
-| T1 Task Breakdown | ATOMIC principles, 2-4 hour granularity | Task decomposition |
-| T2 Context Management | Hot/Warm/Cold layering, load on demand | Knowledge loading |
-| T3 Precision Rollback | Retry only failed items, not full redo | Fix loop |
-| T4 Anti-Pattern Inoculation | Block 6 shortcut paths | Skill design |
-| T5 Taming Non-Determinism | Four defense lines, hypothesis management | Critical decisions |
-| T6 Prioritize Reuse | Search before implement, no hardcoding | Coding / fixing |
-
-#### L4: Operational Principles (4 items)
-
-| Principle | One-Liner | Application Scenario |
-|-----------|-----------|---------------------|
-| O1 Coding Style | SOLID + DDD, Lock-Check-Update | Code writing |
-| O2 Auto-Fix | Analyze→Decide→Execute→Verify, max 3 times | Error handling |
-| O3 Constitution Gate | 15 red lines, stop immediately on violation | Full process |
-| O4 Checklists | 5-stage checklists, embedded self-check | Stage completion |
-
----
-
-## Principle Traceability Chain Examples
-
-**Scenario**: Maven dependency missing error
-
-```
-Error Occurs
-    ↓
-L4-O2 Auto-Fix Mechanism → Error Classification (Dependency Type)
-    ↓
-L3-T6 Prioritize Reusing Project Capabilities → Scan existing pom.xml
-    ↓
-L3-T3 Precision Rollback → Level 2 Fix Loop
-    ↓
-L2-S1 Two-Layer Validation → Re-execute original command for verification
-    ↓
-L1-P1 Verification-First → Verification result passed
-    ↓
-Record practice-log → L3-Evolution Mechanism
-```
-
-**Scenario**: Requirement ambiguity needs clarification
-
-```
-Requirement Ambiguity Identified
-    ↓
-L2-S4 Informed Guessing > Infinite Questions → Make reasonable default + mark
-    ↓
-L3-T5 Taming Non-Determinism → Defense Line 2: Anchor Consistency
-    ↓
-L2-Constitution #11 → Maximum 3 NEEDS CLARIFICATION items
-    ↓
-L3-T4 Anti-Pattern Inoculation → Prevent assumption drift
-    ↓
-L4-templates → Write to requirement document
-```
-
-Complete traceability chain: [00-principles-hierarchy.md](00-principles-hierarchy.md)
-
----
-
-## Evolution Zone Description
-
-| Zone | Description | Change Method |
-|------|-------------|---------------|
-| 🔴 **Frozen** | Constitution, Evolution Rules, Core Principles, Design Philosophy | Human-only changes, requires complete review process |
-| 🟡 **Controlled** | Process Definitions, Universal Skills, Checklists, Coding Standards | Auto-proposed + Human-approved |
-| 🟢 **Free** | Domain Skills, Benchmarks, Support Skills | Auto-evolved + Validator-verified |
-| 🔵 **Environment Knowledge** | Middleware, Components, Integration Knowledge | Project-level auto-optimization |
-
----
-
-## Mapping to Related Documents
-
-| Document Section | Corresponding Document | Description |
-|-----------------|----------------------|-------------|
-| L1 First Principles | [01-first-principles.md](01-first-principles.md) | Triangular Prism P1/P2/P3 |
-| L2 Strategic Principles | [02-strategic-principles.md](02-strategic-principles.md) | S1-S4 |
-| L3 Tactical Principles | [03-tactical-principles.md](03-tactical-principles.md) | T1-T6 |
-| L4 Operational Principles | [04-operational-principles.md](04-operational-principles.md) | O1-O4 |
-| Domain Principles | [05-domain-principles.md](05-domain-principles.md) | DDP/SDP/REP/CEP/CRP/KMP |
-| Methodology Principles | [06-methodology-principles.md](06-methodology-principles.md) | P1-P44 |
-| Cognitive Enhancement Principles | [07-cognitive-principles.md](07-cognitive-principles.md) | CP1-CP10 |
-| Auto-Fix Principles | [08-auto-fix-principles.md](08-auto-fix-principles.md) | AFP1-AFP6 |
-| Project Constitution | [09-constitution.md](09-constitution.md) | 15 Red Lines |
-| Evolution Mechanism | [10-evolution-mechanism.md](10-evolution-mechanism.md) | Three-Layer Self-Evolution System |
-
----
-
-## Usage Guide
-
-### Quick Principle Location
-
-**Scenario**: What principle should I follow for problem X?
-
-1. Identify problem type (Verification / Autonomy / Knowledge / Fix / ...)
-2. Check the Principle Quick Reference Table
-3. Trace upstream principles (understand why)
-4. Check downstream operational standards (know how)
-
-**Example**:
-```
-Problem: "AI always reinvents the wheel, doesn't scan existing code"
-→ Problem Type: Knowledge Management / Reuse
-→ Quick Reference: T6 Prioritize Reusing Project Capabilities
-→ Upstream Principles: P2 Minimal-Viable, S3 Harness Engineering
-→ Downstream Operations: 04-operational-principles.md Coding Standards, 08-auto-fix-principles.md AFP3
-```
-
-### Principle Application Checkpoints
-
-**Before Executing Task**:
-- [ ] Read this document, understand relevant principles
-- [ ] Identified task type and applicable principles
-- [ ] Prepared necessary knowledge (Hot/Warm layers)
-
-**During Task Execution**:
-- [ ] Decompose tasks following ATOMIC principles
-- [ ] Follow Informed Guessing principle (max 3 uncertain items)
-- [ ] Follow Do-Review Separation principle (start independent Agent for review)
-
-**After Task Execution**:
-- [ ] Follow Two-Layer Validation principle (Layer 1 + Layer 2)
-- [ ] Follow Checklist principle (stage self-check)
-- [ ] Follow Practice Log principle (record experience)
-
----
-
-**Maintainer**: AutoSpec Team
-**Feedback Channel**: Knowledge Base Git Repository Issue
-**Related Documents**:
-- [Principles Hierarchy](00-principles-hierarchy.md)
-- [L1 First Principles](01-first-principles.md)
-- [L2 Strategic Principles](02-strategic-principles.md)
-- [L3 Tactical Principles](03-tactical-principles.md)
-- [L4 Operational Principles](04-operational-principles.md)
-- [Domain Practice Principles](05-domain-principles.md)
-- [Methodology Principles](06-methodology-principles.md)
-- [Cognitive Enhancement Principles](07-cognitive-principles.md)
-- [Auto-Fix Principles](08-auto-fix-principles.md)
-- [Project Constitution](09-constitution.md)
-- [Self-Evolution Mechanism](10-evolution-mechanism.md)