@torus-engineering/tas-kit 1.10.0 → 1.11.1

package/README.md

@@ -1,334 +1,334 @@
-# TAS Kit
-
-**Torus Agentic SDLC Kit** — Bộ công cụ AI-assisted SDLC cho Claude Code, được thiết kế theo triết lý Spec-Driven Development và Context-Aware Architecture.
-
----
-
-## Mục đích
-
-TAS Kit giúp các team phát triển phần mềm:
-- **Chuẩn hóa quy trình SDLC** với các artifacts rõ ràng (PRD, SAD, ADR, Epic, Feature, Story)
-- **Tối ưu hóa token usage** thông qua Context Layer — đầu tư ở phase thiết kế, tiết kiệm ở phase code
-- **Hỗ trợ nhiều mô hình làm việc**: từ solo developer đến full team với các role PE/SE/DSE
-- **Tự động hóa** với Hybrid và Autonomous agents hoạt động 24/7
-
----
-
-## Triết lý thiết kế
-
-### Spec-Driven Development
-Tất cả code bắt đầu từ spec. Story.md là "context digest" đã hấp thụ toàn bộ thông tin từ PRD, SAD, ADR, Feature. Mỗi session implement chỉ cần đọc CLAUDE.md + Story.md — không cần load lại toàn bộ artifacts.
-
-### Human-Led, AI-Powered
-- **Con người chủ đạo**: Quyết định architecture, approve design, review code
-- **AI hỗ trợ**: Tạo draft, implement theo spec, chạy tests, phát hiện bugs
-
-### Dual Mode Operation
-- **Hybrid Mode**: Developer và AI làm việc cùng nhau trong session
-- **Autonomous Mode**: AI tự động develop 24/7, report kết quả khi xong
-
-### Lightweight & Context-Aware
-- Mỗi skill < 3KB, tổng kit < 50KB
-- Context Layer: đầu tư token ở phase thiết kế để tiết kiệm gấp nhiều lần ở phase code
-- Khi code: PHẢI bắt đầu session mới (không tận dụng session cũ đã load PRD/SAD vì sẽ phình Window Context)
-
-### Role-Based & Template-Driven
-- 3 role thực tế của Torus: PE (Product Engineer), SE (Software Engineer), DSE (DevOps Engineer)
-- Templates riêng cho PRD, SAD, ADR, Epic, Feature, Story theo chuẩn Torus
-- Flow configurable qua file `tas.yaml`
-
-### Azure DevOps Compatible
-- Output Markdown tương thích Azure DevOps Wiki
-- Mermaid diagrams không dùng ký tự `()` (tránh conflict với ADO syntax)
-
----
-
-## SDLC Workflow
-
-:::mermaid
-graph TD
-    subgraph Phase1["Phase 1: Discovery"]
-        PRD["/tas-prd"]
-        SAD["/tas-sad"]
-        ADR["/tas-adr"]
-        DESIGN["/tas-design"]
-        PRD -->|Product Engineer| PRD_ARTIFACT["PRD.md"]
-        PRD_ARTIFACT -->|Software Engineer| SAD
-        PRD_ARTIFACT -->|Software Engineer| ADR
-        SAD --> SAD_ARTIFACT["SAD.md"]
-        ADR --> ADR_ARTIFACT["ADR-XXX.md"]
-        PRD_ARTIFACT -->|Software Engineer| DESIGN
-        DESIGN --> DESIGN_ARTIFACT["design-spec.md"]
-    end
-
-    subgraph Phase2["Phase 2: Planning"]
-        EPIC["/tas-epic"]
-        FEATURE["/tas-feature"]
-        STORY["/tas-story"]
-        FUNctest["/tas-functest"]
-        PRD_ARTIFACT -->|Software Engineer| EPIC
-        EPIC --> EPIC_ARTIFACT["Epic-XXX/"]
-        EPIC_ARTIFACT -->|Software Engineer| FEATURE
-        FEATURE --> FEATURE_ARTIFACT["Feature-XXX/"]
-        SAD_ARTIFACT --> FEATURE
-        DESIGN_ARTIFACT --> FEATURE
-        FEATURE_ARTIFACT -->|Software Engineer| STORY
-        STORY --> STORY_ARTIFACT["Story-XXX.md"]
-        FEATURE_ARTIFACT -->|Software Engineer| FUNctest
-        FUNctest --> FUNCTEST_ARTIFACT["Functional-Testing-Spec-FeatureXXX.md"]
-    end
-
-    subgraph Phase3["Phase 3: Implementation"]
-        PLAN["/tas-plan"]
-        DEV["/tas-dev"]
-        FIX["/tas-fix"]
-        APItest["/tas-apitest"]
-        E2E["/tas-e2e"]
-        FUNCTEST_WEB["/tas-functest-web"]
-        FUNCTEST_MOBILE["/tas-functest-mobile"]
-        E2E_WEB["/tas-e2e-web"]
-        E2E_MOBILE["/tas-e2e-mobile"]
-        BUG["/tas-bug"]
-        REVIEW["/tas-review"]
-        STORY_ARTIFACT -->|Software Engineer| PLAN
-        PLAN --> PLAN_ARTIFACT["Plan.md"]
-        PLAN_ARTIFACT -->|AI Agent| DEV
-        DEV --> CODE["Source Code"]
-        CODE -->|Bug found| FIX
-        FIX --> CODE
-        CODE -->|Software Engineer| REVIEW
-        REVIEW --> REVIEW_ARTIFACT["Code Review Report"]
-        STORY_ARTIFACT -->|Software Engineer| APItest
-        APItest --> APITEST_ARTIFACT["API Testing Script"]
-        FUNCTEST_ARTIFACT -->|Product Engineer| E2E
-        E2E --> E2E_ARTIFACT["E2E Test Scenarios"]
-        FUNCTEST_ARTIFACT -->|Software Engineer| FUNCTEST_WEB
-        FUNCTEST_WEB --> FUNCTEST_WEB_ARTIFACT["Functional Test Web Script"]
-        FUNCTEST_ARTIFACT -->|Software Engineer| FUNCTEST_MOBILE
-        FUNCTEST_MOBILE --> FUNCTEST_MOBILE_ARTIFACT["Functional Test Mobile Script"]
-        FUNCTEST_ARTIFACT -->|Product Engineer| E2E_WEB
-        E2E_WEB --> E2E_WEB_ARTIFACT["E2E Web Test Script"]
-        FUNCTEST_ARTIFACT -->|Product Engineer| E2E_MOBILE
-        E2E_MOBILE --> E2E_MOBILE_ARTIFACT["E2E Mobile Test Script"]
-        CODE -->|Bug found| BUG
-        BUG --> BUG_ARTIFACT["Bug Report"]
-    end
-
-    subgraph Phase4["Phase 4: Quality & Deploy"]
-        SECURITY["/tas-security"]
-        PIPELINE["Pipeline / CLI"]
-        CODE -->|DevOps Engineer| SECURITY
-        SECURITY --> SECURITY_ARTIFACT["Security Report"]
-        APITEST_ARTIFACT -->|Product Engineer| PIPELINE
-        FUNCTEST_WEB_ARTIFACT --> PIPELINE
-        FUNCTEST_MOBILE_ARTIFACT --> PIPELINE
-        E2E_WEB_ARTIFACT --> PIPELINE
-        E2E_MOBILE_ARTIFACT --> PIPELINE
-        PIPELINE --> TEST_REPORT["Test Report"]
-        SECURITY_ARTIFACT -->|DevOps Engineer| DEPLOY["Production"]
-        TEST_REPORT --> DEPLOY
-    end
-
-    STATUS["/tas-status"] -.->|Track| PRD_ARTIFACT
-    STATUS -.->|Track| SAD_ARTIFACT
-    STATUS -.->|Track| STORY_ARTIFACT
-    STATUS -.->|Track| DEPLOY
-
-    style PRD_ARTIFACT fill:#e1f5ff
-    style SAD_ARTIFACT fill:#fff4e1
-    style DESIGN_ARTIFACT fill:#f3e5f5
-    style STORY_ARTIFACT fill:#e8f5e9
-    style CODE fill:#f3e5f5
-    style TEST_REPORT fill:#c8e6c9
-    style DEPLOY fill:#c8e6c9
-:::
-
-### Phase Summary
-
-| Phase | Role | Commands | Artifacts |
-|-------|------|----------|-----------|
-| **Phase 1: Discovery** | PE, SE | `/tas-prd`, `/tas-sad`, `/tas-adr`, `/tas-design` | PRD.md, SAD.md, ADR-XXX.md, design-spec.md |
-| **Phase 2: Planning** | SE | `/tas-epic`, `/tas-feature`, `/tas-story`, `/tas-functest` | Epic-XXX/, Feature-XXX/, Story-XXX.md, Functional-Testing-Spec-FeatureXXX.md |
-| **Phase 3: Implementation** | PE, SE, AI | `/tas-plan`, `/tas-dev`, `/tas-fix`, `/tas-apitest`, `/tas-e2e`, `/tas-functest-web`, `/tas-functest-mobile`, `/tas-e2e-web`, `/tas-e2e-mobile`, `/tas-bug`, `/tas-review` | Plan.md, Source Code, API Testing Script, E2E Test Scenarios, Functional Test Scripts, Bug Report, Code Review Report |
-| **Phase 4: Quality & Deploy** | PE, DSE | `/tas-security`, Pipeline/CLI | Security Report, Test Report, Production |
-
-### Chi tiết từng Phase
-
-#### Phase 1: Discovery
-- **PE**: Tạo PRD với `/tas-prd`
-- **SE**: Tạo SAD với `/tas-sad`, tạo ADR với `/tas-adr`, tạo design-spec với `/tas-design`
-
-#### Phase 2: Planning
-- **SE**: Breakdown Epic với `/tas-epic`, Feature với `/tas-feature`, Story với `/tas-story`
-- **SE**: Tạo Functional Testing Spec với `/tas-functest`
-
-#### Phase 3: Implementation
-- **SE**: Tạo Plan với `/tas-plan`, Implement với `/tas-dev`, Fix bug với `/tas-fix`
-- **SE**: Review code với `/tas-review`
-- **SE**: Tạo API Testing Script với `/tas-apitest`
-- **PE**: Tạo E2E Test Scenarios với `/tas-e2e`
-- **SE**: Tạo Functional Test Scripts với `/tas-functest-web`, `/tas-functest-mobile`
-- **PE**: Tạo E2E Test Scripts với `/tas-e2e-web`, `/tas-e2e-mobile`
-- **PE**: Tạo Bug Report với `/tas-bug`
-
-#### Phase 4: Quality & Deploy
-- **DSE**: Security Review với `/tas-security`
-- **PE**: Chạy Pipeline/CLI để execute Automation Tests
-- **DSE**: Deploy lên Production
-
----
-
-## Quick Start
-
-```bash
-npx @torus-engineering/tas-kit install
-```
-
-### Options
-
-```bash
-npx @torus-engineering/tas-kit install --directory /path/to/my-project
-npx @torus-engineering/tas-kit install --yes    # skip confirmation prompts
-```
-
----
-
-## Thiết lập quan trọng
-
-### CLAUDE.md
-
-File cấu hình quan trọng nhất — Claude đọc file này đầu tiên trong mọi session.
-
-**Cấu trúc:**
-```markdown
-# Project Name
-
-## Tech Stack
-- Backend: .NET / Node.js / Python
-- Frontend: React / Next.js
-- Database: PostgreSQL / MySQL
-- Infrastructure: AWS / Azure
-
-## Conventions
-- Coding standards
-- Architecture patterns
-- Testing requirements
-```
-
-### tas.yaml
-
-Điều khiển flow của TAS Kit theo từng dự án.
-
-**Cấu trúc:**
-```yaml
-project:
-  name: "My Project"
-  team: "Team Name"
-
-azure_devops:
-  enabled: true
-  organization: "org"
-  project: "project"
-
-flow:
-  mode: "greenfield"  # or "brownfield"
-  use_tdd: true
-  auto_review: true
-```
-
-### project-status.yaml
-
-Index tổng hợp trạng thái dự án — được cập nhật tự động sau mỗi thay đổi artifact.
-
-**Cấu trúc:**
-```yaml
-last_updated: 2025-01-15
-
-artifacts:
-  prd:
-    file: docs/prd.md
-    status: Approved
-    version: "1.0"
-
-epics:
-  Epic-001:
-    status: Active
-    features:
-      Feature-001:
-        stories:
-          Story-001:
-            status: In Progress
-```
-
-### .env
-
-Environment variables cho Azure DevOps integration.
-
-```bash
-AZURE_DEVOPS_PAT=your_pat_here
-AZURE_DEVOPS_ORG=your_org
-AZURE_DEVOPS_PROJECT=your_project
-```
-
----
-
-## What gets installed
-
-```
-.claude/
-  commands/   22 slash commands (/tas-*, /ado-*)
-  skills/     3 auto-invoked skills
-  agents/     29 specialized subagents
-.tas/
-  templates/  Markdown templates (PRD, SAD, ADR, Epic, Feature, Story...)
-  checklists/ Code review, story done, security checklists
-  tools/      ADO integration script (tas-ado.py)
-CLAUDE.md     Project context template (edit this for your project)
-tas.yaml      Flow configuration template (edit this for your project)
-.env.example  Environment variable template
-```
-
----
-
-## Commands Reference
-
-| Command | Mô tả | Role |
-|---------|-------|------|
-| `/tas-init` | Khởi tạo TAS cho dự án mới | All |
-| `/tas-status` | Hiển thị trạng thái hiện tại của dự án | All |
-| `/tas-prd` | Tạo/cập nhật Product Requirements Document | PE |
-| `/tas-sad` | Tạo/cập nhật Solution Architecture Document | SE |
-| `/tas-adr` | Tạo Architecture Decision Record | SE |
-| `/tas-design` | Tạo Design Specification | SE |
-| `/tas-epic` | Tạo/cập nhật Epic | SE |
-| `/tas-feature` | Tạo/cập nhật Feature | SE |
-| `/tas-story` | Tạo/cập nhật Story | SE |
-| `/tas-functest` | Tạo Functional Testing Specification | SE |
-| `/tas-spec` | Lightweight spec (solo / prototype) | SE |
-| `/tas-plan` | Lập kế hoạch kỹ thuật implementation | SE |
-| `/tas-dev` | Implement story (agentic) | AI |
-| `/tas-fix` | Quick fix không cần full story flow | SE |
-| `/tas-apitest` | Tạo API Testing Script tự động | SE |
-| `/tas-e2e` | Tạo E2E Test Scenarios | PE |
-| `/tas-functest-web` | Tạo Functional Test Script cho Web | SE |
-| `/tas-functest-mobile` | Tạo Functional Test Script cho Mobile | SE |
-| `/tas-e2e-web` | Tạo E2E Test Script cho Web | PE |
-| `/tas-e2e-mobile` | Tạo E2E Test Script cho Mobile | PE |
-| `/tas-bug` | Tạo Bug Report | PE |
-| `/tas-review` | Code Review với checklist | SE |
-| `/tas-brainstorm` | Brainstorm giải pháp | All |
-| `/tas-security` | Security Review | DSE |
-| `/ado-*` | Azure DevOps integration | All |
-
----
-
-## Requirements
-
-- Node.js 18+
-- [Claude Code](https://claude.ai/code)
-
----
-
-## Documentation
-
-Xem `.tas/README.md` sau khi install để có tài liệu chi tiết.
+# TAS Kit
+
+**Torus Agentic SDLC Kit** — AI-assisted SDLC toolkit, designed following Spec-Driven Development philosophy and Context-Aware Architecture.
+
+---
+
+## Purpose
+
+TAS Kit helps software development teams:
+- **Standardize SDLC process** with clear artifacts (PRD, SAD, ADR, Epic, Feature, Story)
+- **Optimize token usage** through Context Layer — invest in design phase, save in code phase
+- **Support multiple workflows**: from solo developer to full team with PE/SE/DSE roles
+- **Automate** with Hybrid and Autonomous agents operating 24/7
+
+---
+
+## Design Philosophy
+
+### Spec-Driven Development
+All code starts from spec. Story.md is "context digest" that has absorbed all information from PRD, SAD, ADR, Feature. Each implementation session only needs to read CLAUDE.md + Story.md — no need to reload all artifacts.
+
+### Human-Led, AI-Powered
+- **Human-led**: Architecture decisions, design approval, code review
+- **AI-assisted**: Draft creation, implementation per spec, test execution, bug detection
+
+### Dual Mode Operation
+- **Hybrid Mode**: Developer and AI work together in session
+- **Autonomous Mode**: AI automatically develops 24/7, reports results when done
+
+### Lightweight & Context-Aware
+- Each skill < 3KB, total kit < 50KB
+- Context Layer: invest tokens in design phase to save many times in code phase
+- When coding: MUST start new session (don't reuse old session that loaded PRD/SAD to avoid Window Context bloat)
+
+### Role-Based & Template-Driven
+- 3 actual roles at Torus: PE (Product Engineer), SE (Software Engineer), DSE (DevOps Engineer)
+- Separate templates for PRD, SAD, ADR, Epic, Feature, Story per Torus standards
+- Flow configurable via `tas.yaml` file
+
+### Azure DevOps Compatible
+- Markdown output compatible with Azure DevOps Wiki
+- Mermaid diagrams don't use `()` characters (avoid conflict with ADO syntax)
+
+---
+
+## SDLC Workflow
+
+:::mermaid
+graph TD
+    subgraph Phase1["Phase 1: Discovery"]
+        PRD["/tas-prd"]
+        SAD["/tas-sad"]
+        ADR["/tas-adr"]
+        DESIGN["/tas-design"]
+        PRD -->|Product Engineer| PRD_ARTIFACT["PRD.md"]
+        PRD_ARTIFACT -->|Software Engineer| SAD
+        PRD_ARTIFACT -->|Software Engineer| ADR
+        SAD --> SAD_ARTIFACT["SAD.md"]
+        ADR --> ADR_ARTIFACT["ADR-XXX.md"]
+        PRD_ARTIFACT -->|Product Engineer| DESIGN
+        DESIGN --> DESIGN_ARTIFACT["design-spec.md"]
+    end
+
+    subgraph Phase2["Phase 2: Planning"]
+        EPIC["/tas-epic"]
+        FEATURE["/tas-feature"]
+        STORY["/tas-story"]
+        PRD_ARTIFACT -->|Product Engineer| EPIC
+        EPIC --> EPIC_ARTIFACT["Epic-XXX/"]
+        EPIC_ARTIFACT -->|Product Engineer| FEATURE
+        FEATURE --> FEATURE_ARTIFACT["Feature-XXX/"]
+        SAD_ARTIFACT --> FEATURE
+        DESIGN_ARTIFACT --> FEATURE
+        FEATURE_ARTIFACT -->|Product Engineer| STORY
+        STORY --> STORY_ARTIFACT["Story-XXX.md"]
+    end
+
+    subgraph Phase3["Phase 3: Implementation"]
+        PLAN["/tas-plan"]
+        DEV["/tas-dev"]
+        FIX["/tas-fix"]
+        APItest["/tas-apitest"]
+        E2E["/tas-e2e"]
+        FUNCTEST_WEB["/tas-functest-web"]
+        FUNCTEST_MOBILE["/tas-functest-mobile"]
+        E2E_WEB["/tas-e2e-web"]
+        E2E_MOBILE["/tas-e2e-mobile"]
+        BUG["/tas-bug"]
+        REVIEW["/tas-review"]
+        FUNctest["/tas-functest"]
+        STORY_ARTIFACT -->|Software Engineer| PLAN
+        PLAN --> STORY_ARTIFACT
+        STORY_ARTIFACT -->|AI Agent| DEV
+        DEV --> CODE["Source Code"]
+        CODE -->|Bug found| FIX
+        FIX --> CODE
+        CODE -->|Software Engineer| REVIEW
+        REVIEW --> REVIEW_ARTIFACT["Code Review Report"]
+        STORY_ARTIFACT -->|Software Engineer| APItest
+        APItest --> APITEST_ARTIFACT["API Testing Script"]
+        FUNCTEST_ARTIFACT -->|Product Engineer| E2E
+        E2E --> E2E_ARTIFACT["E2E Test Scenarios"]
+        FUNCTEST_ARTIFACT -->|Software Engineer| FUNCTEST_WEB
+        FUNCTEST_WEB --> FUNCTEST_WEB_ARTIFACT["Functional Test Web Script"]
+        FUNCTEST_ARTIFACT -->|Software Engineer| FUNCTEST_MOBILE
+        FUNCTEST_MOBILE --> FUNCTEST_MOBILE_ARTIFACT["Functional Test Mobile Script"]
+        FUNCTEST_ARTIFACT -->|Product Engineer| E2E_WEB
+        E2E_WEB --> E2E_WEB_ARTIFACT["E2E Web Test Script"]
+        FUNCTEST_ARTIFACT -->|Product Engineer| E2E_MOBILE
+        E2E_MOBILE --> E2E_MOBILE_ARTIFACT["E2E Mobile Test Script"]
+        CODE -->|Bug found| BUG
+        BUG --> BUG_ARTIFACT["Bug Report"]
+        FEATURE_ARTIFACT -->|Product Engineer| FUNctest
+        FUNctest --> FUNCTEST_ARTIFACT["Functional-Testing-Spec-FeatureXXX.md"]
+    end
+
+    subgraph Phase4["Phase 4: Quality & Deploy"]
+        SECURITY["/tas-security"]
+        PIPELINE["Pipeline / CLI"]
+        CODE -->|DevOps Engineer| SECURITY
+        SECURITY --> SECURITY_ARTIFACT["Security Report"]
+        APITEST_ARTIFACT -->|Product Engineer| PIPELINE
+        FUNCTEST_WEB_ARTIFACT --> PIPELINE
+        FUNCTEST_MOBILE_ARTIFACT --> PIPELINE
+        E2E_WEB_ARTIFACT --> PIPELINE
+        E2E_MOBILE_ARTIFACT --> PIPELINE
+        PIPELINE --> TEST_REPORT["Test Report"]
+        SECURITY_ARTIFACT -->|DevOps Engineer| DEPLOY["Production"]
+        TEST_REPORT --> DEPLOY
+    end
+
+    STATUS["/tas-status"] -.->|Track| PRD_ARTIFACT
+    STATUS -.->|Track| SAD_ARTIFACT
+    STATUS -.->|Track| STORY_ARTIFACT
+    STATUS -.->|Track| DEPLOY
+
+    style PRD_ARTIFACT fill:#e1f5ff
+    style SAD_ARTIFACT fill:#fff4e1
+    style DESIGN_ARTIFACT fill:#f3e5f5
+    style STORY_ARTIFACT fill:#e8f5e9
+    style CODE fill:#f3e5f5
+    style TEST_REPORT fill:#c8e6c9
+    style DEPLOY fill:#c8e6c9
+:::
+
+### Phase Summary
+
+| Phase | Role | Commands | Artifacts |
+|-------|------|----------|-----------|
+| **Phase 1: Discovery** | PE, SE | `/tas-prd`, `/tas-sad`, `/tas-adr`, `/tas-design` | PRD.md, SAD.md, ADR-XXX.md, design-spec.md |
+| **Phase 2: Planning** | SE | `/tas-epic`, `/tas-feature`, `/tas-story`, `/tas-functest` | Epic-XXX/, Feature-XXX/, Story-XXX.md, Functional-Testing-Spec-FeatureXXX.md |
+| **Phase 3: Implementation** | PE, SE, AI | `/tas-plan`, `/tas-dev`, `/tas-fix`, `/tas-apitest`, `/tas-e2e`, `/tas-functest-web`, `/tas-functest-mobile`, `/tas-e2e-web`, `/tas-e2e-mobile`, `/tas-bug`, `/tas-review` | Plan.md, Source Code, API Testing Script, E2E Test Scenarios, Functional Test Scripts, Bug Report, Code Review Report |
+| **Phase 4: Quality & Deploy** | PE, DSE | `/tas-security`, Pipeline/CLI | Security Report, Test Report, Production |
+
+### Phase Details
+
+#### Phase 1: Discovery
+- **PE**: Create PRD with `/tas-prd`, create design-spec with `/tas-design`
+- **SE**: Create SAD with `/tas-sad`, create ADR with `/tas-adr`
+
+#### Phase 2: Planning
+- **PE**: Breakdown Epic with `/tas-epic`, Feature with `/tas-feature`, Story with `/tas-story`
+
+#### Phase 3: Implementation
+- **SE**: Create Plan with `/tas-plan`, Implement with `/tas-dev`, Fix bug with `/tas-fix`
+- **SE**: Review code with `/tas-review`
+- **PE**: Create Functional Testing Spec with `/tas-functest`
+- **SE**: Create API Testing Script with `/tas-apitest`
+- **PE**: Create E2E Test Scenarios with `/tas-e2e`
+- **SE**: Create Functional Test Scripts with `/tas-functest-web`, `/tas-functest-mobile`
+- **PE**: Create E2E Test Scripts with `/tas-e2e-web`, `/tas-e2e-mobile`
+- **PE**: Create Bug Report with `/tas-bug`
+
+#### Phase 4: Quality & Deploy
+- **DSE**: Security Review with `/tas-security`
+- **PE**: Run Pipeline/CLI to execute Automation Tests
+- **DSE**: Deploy to Production
+
+---
+
+## Quick Start
+
+```bash
+npx @torus-engineering/tas-kit install
+```
+
+### Options
+
+```bash
+npx @torus-engineering/tas-kit install --directory /path/to/my-project
+npx @torus-engineering/tas-kit install --yes    # skip confirmation prompts
+```
+
+---
+
+## Important Setup
+
+### CLAUDE.md
+
+Most important configuration file — Claude reads this file first in every session.
+
+**Structure:**
+```markdown
+# Project Name
+
+## Tech Stack
+- Backend: .NET / Node.js / Python
+- Frontend: React / Next.js
+- Database: PostgreSQL / MySQL
+- Infrastructure: AWS / Azure
+
+## Conventions
+- Coding standards
+- Architecture patterns
+- Testing requirements
+```
+
+### tas.yaml
+
+Controls TAS Kit flow per project.
+
+**Structure:**
+```yaml
+project:
+  name: "My Project"
+  team: "Team Name"
+
+azure_devops:
+  enabled: true
+  organization: "org"
+  project: "project"
+
+flow:
+  mode: "greenfield"  # or "brownfield"
+  use_tdd: true
+  auto_review: true
+```
+
+### project-status.yaml
+
+Project status index — automatically updated after each artifact change.
+
+**Structure:**
+```yaml
+last_updated: 2025-01-15
+
+artifacts:
+  prd:
+    file: docs/prd.md
+    status: Approved
+    version: "1.0"
+
+epics:
+  Epic-001:
+    status: Active
+    features:
+      Feature-001:
+        stories:
+          Story-001:
+            status: In Progress
+```
+
+### .env
+
+Environment variables for Azure DevOps integration.
+
+```bash
+AZURE_DEVOPS_PAT=your_pat_here
+AZURE_DEVOPS_ORG=your_org
+AZURE_DEVOPS_PROJECT=your_project
+```
+
+---
+
+## What gets installed
+
+```
+.claude/
+  commands/   22 slash commands (/tas-*, /ado-*)
+  skills/     3 auto-invoked skills
+  agents/     29 specialized subagents
+.tas/
+  templates/  Markdown templates (PRD, SAD, ADR, Epic, Feature, Story...)
+  checklists/ Code review, story done, security checklists
+  tools/      ADO integration script (tas-ado.py)
+CLAUDE.md     Project context template (edit this for your project)
+tas.yaml      Flow configuration template (edit this for your project)
+.env.example  Environment variable template
+```
+
+---
+
+## Commands Reference
+
+| Command | Description | Role |
+|---------|-------------|------|
+| `/tas-init` | Initialize TAS for new project | All |
+| `/tas-status` | Display current project status | All |
+| `/tas-prd` | Create/update Product Requirements Document | PE |
+| `/tas-sad` | Create/update Solution Architecture Document | SE |
+| `/tas-adr` | Create Architecture Decision Record | SE |
+| `/tas-design` | Create Design Specification | SE |
+| `/tas-epic` | Create/update Epic | SE |
+| `/tas-feature` | Create/update Feature | SE |
+| `/tas-story` | Create/update Story | SE |
+| `/tas-functest` | Create Functional Testing Specification | SE |
+| `/tas-spec` | Lightweight spec (solo / prototype) | SE |
+| `/tas-plan` | Create technical implementation plan | SE |
+| `/tas-dev` | Implement story (agentic) | AI |
+| `/tas-fix` | Quick fix without full story flow | SE |
+| `/tas-apitest` | Create API Testing Script automatically | SE |
+| `/tas-e2e` | Create E2E Test Scenarios | PE |
+| `/tas-functest-web` | Create Functional Test Script for Web | SE |
+| `/tas-functest-mobile` | Create Functional Test Script for Mobile | SE |
+| `/tas-e2e-web` | Create E2E Test Script for Web | PE |
+| `/tas-e2e-mobile` | Create E2E Test Script for Mobile | PE |
+| `/tas-bug` | Create Bug Report | PE |
+| `/tas-review` | Code Review with checklist | SE |
+| `/tas-brainstorm` | Brainstorm solutions | All |
+| `/tas-security` | Security Review | DSE |
+| `/ado-*` | Azure DevOps integration | All |
+
+---
+
+## Requirements
+
+- Node.js 18+
+- [Claude Code](https://claude.ai/code)
+
+---
+
+## Documentation
+
+See `.tas/README.md` after install for detailed documentation.