@torus-engineering/tas-kit 1.5.0 → 1.6.0

package/.tas/templates/Story.md

@@ -7,6 +7,8 @@ ado_assigned_to:
 ado_created:
 last_ado_sync:
 parent_ado_id:
+plan_status: pending
+plan_date:
 ---
 # Story-{NNN}: {Title}
 
@@ -20,25 +22,20 @@ parent_ado_id:
 As a {role}, I want {goal}, so that {benefit}.
 
 ---
-## Context from PRD (nếu có)
-*(Chỉ thêm section này khi Story có business requirements đặc biệt cần lưu ý)*
+## Business Requirements (nếu có)
+*(Yêu cầu nghiệp vụ đặc biệt, business rules, constraints từ stakeholders — chỉ thêm khi cần)*
 
 ---
-## Context from SAD/ADR (nếu có)
-*(Chỉ thêm section này khi Story có architecture decisions, patterns, hoặc constraints cần tuân thủ)*
-
-- **Relevant Components:** {components liên quan}
-- **Patterns to follow:** {patterns từ SAD/ADR}
-- **Constraints:** {nếu có}
+## Design Notes (nếu có)
+*(UI/UX specs, mockup links, design decisions, flow diagrams — chỉ thêm khi cần)*
 
 ---
-## Prerequisites from Feature (nếu có)
-*(Chỉ thêm section này khi Story có dependency từ Stories khác hoặc prerequisites)*
+## Prerequisites (nếu có)
+*(Dependencies từ Stories khác hoặc điều kiện phải có trước — chỉ thêm khi cần)*
 
 ---
-## Implementation Context
-
 ## Acceptance Criteria
+
 ### AC-1: {title}
 - **Given** {precondition}
 - **When** {action}
@@ -49,13 +46,9 @@ As a {role}, I want {goal}, so that {benefit}.
 - **When** {action}
 - **Then** {expected result}
 
-## Technical Notes
-- **Files to modify:** {list}
-- **Patterns:** {reference to SAD/ADR}
-- **Database changes:** {if any}
-
+---
 ## Unit Test Cases
-SE implement trong code. PE thiết kế happy path + edge cases + negative cases khi tạo Story.
+*(PE thiết kế happy path + edge cases + negative cases. SE implement trong code.)*
 
 ### Happy Path
 | ID | Description | Input | Expected Output |
@@ -75,7 +68,14 @@ SE implement trong code. PE thiết kế happy path + edge cases + negative case
 ### Dependencies to Mock
 - {external API, database state, third-party service...}
 
+---
+<!-- ═══════════════════════════════════════════════════════════════════
+     TECHNICAL PLAN — generated by /tas-plan, do not edit manually
+     ═══════════════════════════════════════════════════════════════════ -->
+
+---
 ## Definition of Done
+- [ ] Technical plan completed (`/tas-plan`)
 - [ ] Code implemented
 - [ ] Unit tests pass
 - [ ] Code review passed

package/CLAUDE-Example.md

@@ -41,7 +41,7 @@ This project uses Torus-Agentic-SDLC (TAS) kit.
 ## Commands
 Type /tas-status to see current project state.
 Type /tas-[artifact] to create or update artifacts (prd, sad, adr, epic, feature, story, design).
-Type /tas-dev-story to implement a story.
+Type /tas-dev to implement a story.
 Type /tas-verify to verify a Feature on Staging (Phase 2).
 Type /tas-review-code, /tas-brainstorm, /tas-bug, /tas-security-check for dev workflows.
 

package/README.md

@@ -5,23 +5,23 @@
 ## Quick Start
 
 ```bash
-npx tas-kit install
+npx @torus-engineering/tas-kit install
 ```
 
 ## Options
 
 ```bash
-npx tas-kit install --directory /path/to/my-project
-npx tas-kit install --yes    # skip confirmation prompts
+npx @torus-engineering/tas-kit install --directory /path/to/my-project
+npx @torus-engineering/tas-kit install --yes    # skip confirmation prompts
 ```
 
 ## What gets installed
 
 ```
 .claude/
-  commands/   20 slash commands (/tas-*, /ado-*)
+  commands/   22 slash commands (/tas-*, /ado-*)
   skills/     3 auto-invoked skills
-  agents/     2 specialized subagents
+  agents/     29 specialized subagents
 .tas/
   templates/  Markdown templates (PRD, SAD, ADR, Epic, Feature, Story...)
   checklists/ Code review, story done, security checklists
@@ -49,11 +49,14 @@ tas.yaml      Flow configuration template (edit this for your project)
 | `/tas-epic` | Create/update Epic |
 | `/tas-feature` | Create/update Feature |
 | `/tas-story` | Create/update Story |
-| `/tas-dev-story` | Implement a story (agentic) |
-| `/tas-review-code` | Code review with checklist |
+| `/tas-spec` | Lightweight spec (solo / prototype) |
+| `/tas-plan` | Plan technical implementation |
+| `/tas-dev` | Implement a story (agentic) |
+| `/tas-fix` | Quick fix without full story flow |
+| `/tas-review` | Code review with checklist |
 | `/tas-brainstorm` | Brainstorm solutions |
 | `/tas-bug` | Create bug report |
-| `/tas-security-check` | Security review |
+| `/tas-security` | Security review |
 | `/tas-verify` | Verify feature on staging |
 | `/ado-*` | Azure DevOps integration |
 
@@ -62,6 +65,18 @@ tas.yaml      Flow configuration template (edit this for your project)
 - Node.js 18+
 - [Claude Code](https://claude.ai/code)
 
+## Publishing to npm
+
+```bash
+# Bump version (patch / minor / major)
+npm version patch
+
+# Publish to npm registry
+npm publish --access=public --auth-type=web
+```
+
+`--auth-type=web` mở trình duyệt để xác thực nếu chưa login. Chạy `npm whoami` để kiểm tra đang đăng nhập với account nào trước khi publish.
+
 ## Documentation
 
 See `.tas/README.md` after install for full kit documentation.

package/bin/cli.js

@@ -9,7 +9,7 @@ function printHelp() {
 tas-kit — Torus Agentic SDLC Kit installer
 
 Usage:
-  npx tas-kit install [options]
+  npx @torus-engineering/tas-kit install [options]
 
 Options:
   --directory <path>   Target directory (default: current working directory)
@@ -17,9 +17,9 @@ Options:
   --help, -h           Show this help message
 
 Examples:
-  npx tas-kit install
-  npx tas-kit install --directory /path/to/my-project
-  npx tas-kit install --yes
+  npx @torus-engineering/tas-kit install
+  npx @torus-engineering/tas-kit install --directory /path/to/my-project
+  npx @torus-engineering/tas-kit install --yes
   `.trim());
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@torus-engineering/tas-kit",
-  "version": "1.5.0",
+  "version": "1.6.0",
   "description": "Torus Agentic SDLC Kit — Claude Code commands, skills and workflows for modern AI-assisted SDLC",
   "type": "module",
   "bin": {

package/.claude/commands/tas-dev-story.md

@@ -1,61 +0,0 @@
-# /tas-dev-story $ARGUMENTS
-
-Vai trò: SE - Software Engineer
-Implement một User Story.
-
-## QUAN TRỌNG - Quy tắc đọc file
-- CHỈ đọc DUY NHẤT Story file. Không đọc thêm bất kỳ file nào khác.
-- KHÔNG đọc PRD, SAD, ADR, Design-Spec.
-- KHÔNG list thư mục, KHÔNG quét project structure.
-- KHÔNG đọc .tas/checklists/story-done.md ở bước đầu (chỉ đọc ở bước cuối).
-- Nếu cần tra cứu thêm, PHẢI hỏi user xác nhận trước khi đọc bất kỳ file nào.
-
-## Hành động
-1. $ARGUMENTS là Story ID hoặc file path. Nếu không có, quét docs/epics/**/Story-*.md tìm stories có status Committed.
-2. Đọc Story file.
-3. **Phân tích kiến trúc:**
-   - Kiểm tra vấn đề kỹ thuật đã được mô tả trong SAD/ADR chưa (qua section Context from SAD/ADR trong Story)
-   - Nếu có và không thay đổi kiến trúc → Chuyển sang implement, mô tả giải pháp thi công (API, DB, FE component, config...)
-   - Nếu chưa có hoặc là thay đổi kiến trúc lớn → **TẠO ADR mới**:
-     - Command: `/tas-adr "{Tiêu đề quyết định kiến trúc}"`
-     - Template: `.tas/templates/ADR.md`
-     - Điền đầy đủ: Context, Decision, Rationale, Alternatives, Consequences
-     - Trong section Consequences, thêm subsection **SAD Updates** liệt kê các thay đổi cần cập nhật vào SAD
-4. Bắt đầu implement dựa trên nội dung Story và ADR (nếu đã tạo).
-
-## Workflow
-### Nếu use_tdd = true trong root/tas.yaml:
-a. Viết test cases TRƯỚC (Red phase)
-   - Unit tests theo acceptance criteria trong Story
-   - Chạy tests, xác nhận FAIL
-b. Implement code (Green phase)
-   - Viết code tối thiểu để pass tests
-c. Refactor
-   - Clean up code
-   - Đảm bảo tests vẫn pass
-
-### Nếu use_tdd = false:
-a. Implement code theo acceptance criteria trong Story
-b. Viết unit tests cover các cases
-c. Chạy tests, fix nếu fail
-
-## Sau khi code xong
-3. Đọc .tas/checklists/story-done.md, verify từng mục, sau đó tick vào section ## Definition of Done trong file Story:
-   - `- [x] Code implemented` nếu đã implement xong
-   - `- [x] Unit tests pass` nếu tests đã chạy pass
-   - `- [x] No regression` nếu toàn bộ test suite pass
-   - `- [x] Documentation updated (if needed)` nếu đã cập nhật
-   - `- [ ] Code review passed` — KHÔNG tick, để sau khi chạy /tas-review-code
-   - `- [ ] Acceptance criteria verified` — KHÔNG tick, để PE verify
-4. Tạo commit message theo conventions trong CLAUDE.md
-5. Nhắc user: chạy /tas-review-code để review và tự test lại ở local trước khi chuyển status
-
-## Nguyên tắc
-- KHÔNG implement ngoài scope của Story
-- Mỗi public method PHẢI có XML doc comment
-- **Khi nào cần tạo ADR:**
-  - Thay đổi kiến trúc ảnh hưởng nhiều components
-  - Thêm mới design pattern hoặc framework
-  - Đổi data flow hoặc integration pattern
-  - Quyết định trade-off kỹ thuật quan trọng
-  - Thay đổi đã ảnh hưởng đến SAD

package/.claude/commands/tas-review-code.md

@@ -1,42 +0,0 @@
-# /tas-review-code $ARGUMENTS
-
-Vai trò: SE - Software Engineer
-Review code thay đổi gần nhất hoặc một file/PR cụ thể.
-
-## Hành động
-1. Cần context từ root/tas.yaml và .tas/checklists/code-review.md
-2. $ARGUMENTS có thể là: file path, hoặc để trống (review git diff)
-3. Nếu $ARGUMENTS trống: lấy git diff của staged changes hoặc last commit
-4. Review theo checklist:
-   - Naming conventions
-   - Architecture alignment (so với SAD)
-   - Error handling
-   - Security concerns
-   - Test coverage
-   - Performance implications
-5. Output: danh sách findings phân loại theo severity (Critical/Major/Minor/Info)
-
-## Sau khi review
-6. Nếu có findings Critical/Major: liệt kê rõ, yêu cầu human fix trước khi tiếp tục.
-7. Khi human xác nhận đã fix hết tất cả issues:
-   - Tick `- [x] Code review passed` trong section ## Definition of Done của file Story
-8. Hỏi: "Bạn đã tự test lại ở local chưa? Nếu OK, có muốn chuyển ticket sang Deploy Test không?"
-9. Nếu human xác nhận Yes, cập nhật file Story:
-   a. Dòng **Status:** trong header → Deploy Test
-   b. Cập nhật Technical notes nếu có thay đổi phát sinh trong quá trình review
-   c. Thêm dòng vào section Changelog trong Story: ngày, "Code review passed, moved to Deploy Test"
-10. Cập nhật Story trên ADO:
-   - Chạy /ado-update story <ado-id> --status "Deploy Test" để push nội dung mới nhất và đổi state
-11. Cập nhật file Feature cha:
-   a. Dòng **Status:** trong header → In Progress
-   b. Cột Status của Story trong bảng ## User Stories → Deploy Test
-   c. Thêm dòng Changelog trong Feature: ngày, "Story <id> moved to Deploy Test"
-12. Cập nhật Feature trên ADO:
-   - Chạy /ado-update feature <feature-ado-id> --status "In Progress" để push nội dung mới nhất và đổi state
-13. Cập nhật root/project-status.yaml: Story → Deploy Test, Feature → In Progress
-
-## Nguyên tắc
-- Review khách quan, chỉ ra cụ thể dòng code và lý do
-- Đề xuất fix cụ thể, không chỉ nói "code xấu"
-- Check xem code có vi phạm ADR nào không
-- KHÔNG tự động chuyển status mà không có xác nhận của human

package/.claude/commands/tas-security-check.md

@@ -1,30 +0,0 @@
-# /tas-security-check $ARGUMENTS
-
-Vai trò: DSE - DevSecOps Engineer
-Kiểm tra bảo mật codebase, lưu báo cáo vào docs/security-report.md.
-
-## Hành động
-1. Cần context từ .tas/checklists/security.md
-2. $ARGUMENTS có thể là: file path, hoặc để trống (scan toàn bộ)
-3. Kiểm tra theo OWASP Top 10:
-   - SQL Injection
-   - XSS
-   - Authentication/Authorization issues
-   - Sensitive data exposure
-   - Security misconfiguration
-   - Insecure deserialization
-4. Kiểm tra thêm cho .NET:
-   - Anti-forgery tokens
-   - CORS configuration
-   - Connection string exposure
-   - Proper use of Data Protection API
-5. Kiểm tra docs/security-report.md đã tồn tại chưa:
-   - Chưa có: tạo mới theo template
-   - Đã có: append thêm report mới, cập nhật status findings cũ nếu đã fix
-6. Lưu output vào docs/security-report.md
-7. Cập nhật root/project-status.yaml: artifacts.security_report
-
-## Nguyên tắc
-- Phân loại: Critical/High/Medium/Low
-- Mỗi finding phải có recommended fix cụ thể
-- Finding có status: Open | In Progress | Fixed | Accepted Risk