spec-lite 1.0.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/bin/cli.js +26 -0
- package/package.json +20 -0
- package/skills/planning-and-task-breakdown/SKILL.md +249 -0
- package/skills/scaffold/SKILL.md +294 -0
- package/skills/spec-domain/SKILL.md +176 -0
- package/skills/spec-new/SKILL.md +263 -0
- package/skills/spec-plan/SKILL.md +193 -0
- package/skills/spec-prd/SKILL.md +176 -0
- package/skills/spec-sad/SKILL.md +202 -0
- package/skills/spec-tech/SKILL.md +195 -0
- package/skills/test-driven-development/SKILL.md +379 -0
- package/templates/integrations/plan-template.md +42 -0
- package/templates/integrations/spec-template.md +68 -0
- package/templates/integrations/tech-template.md +59 -0
- package/templates/integrations/todo-template.md +22 -0
- package/templates/main/domain-template.md +60 -0
- package/templates/main/feature/fdd-template.md +55 -0
- package/templates/main/feature/frd-template.md +73 -0
- package/templates/main/prd-template.md +53 -0
- package/templates/main/sad-template.md +68 -0
|
@@ -0,0 +1,73 @@
|
|
|
1
|
+
---
|
|
2
|
+
id: frd-{feature}
|
|
3
|
+
type: frd
|
|
4
|
+
status: draft
|
|
5
|
+
owner: "{BA}"
|
|
6
|
+
feature_id: "{Feature ID từ PRD Feature Index}"
|
|
7
|
+
referenced_by:
|
|
8
|
+
- conventions.md > 3. Main Artifacts > 3.2 Feature level > frd.md > Cấu trúc
|
|
9
|
+
- skills/spec-new/SKILL.md > Process > Bước 5: Write — sinh draft > Cascade Proposals > frd.md
|
|
10
|
+
---
|
|
11
|
+
|
|
12
|
+
# Feature: {Feature Name}
|
|
13
|
+
|
|
14
|
+
## Overview
|
|
15
|
+
|
|
16
|
+
{Mô tả feature này giải quyết vấn đề gì cho user nào, trong 2-3 câu.}
|
|
17
|
+
|
|
18
|
+
## Feature-level Acceptance Criteria
|
|
19
|
+
|
|
20
|
+
Criteria áp dụng cho toàn bộ feature — không gắn với story cụ thể (ví dụ: performance, security, accessibility).
|
|
21
|
+
|
|
22
|
+
- [ ] GIVEN {precondition}
|
|
23
|
+
WHEN {action}
|
|
24
|
+
THEN {expected outcome}
|
|
25
|
+
|
|
26
|
+
## User Stories
|
|
27
|
+
|
|
28
|
+
### US-001: {Story title}
|
|
29
|
+
|
|
30
|
+
As a {persona}, I want to {action} so that {value}.
|
|
31
|
+
|
|
32
|
+
**Priority:** Must / Should / Could
|
|
33
|
+
|
|
34
|
+
**Acceptance Criteria:**
|
|
35
|
+
|
|
36
|
+
- [ ] GIVEN {precondition}
|
|
37
|
+
WHEN {action}
|
|
38
|
+
THEN {expected outcome}
|
|
39
|
+
- [ ] GIVEN {precondition}
|
|
40
|
+
WHEN {action}
|
|
41
|
+
THEN {expected outcome}
|
|
42
|
+
|
|
43
|
+
---
|
|
44
|
+
|
|
45
|
+
### US-002: {Story title}
|
|
46
|
+
|
|
47
|
+
As a {persona}, I want to {action} so that {value}.
|
|
48
|
+
|
|
49
|
+
**Priority:** Must / Should / Could
|
|
50
|
+
|
|
51
|
+
**Acceptance Criteria:**
|
|
52
|
+
|
|
53
|
+
- [ ] GIVEN {precondition}
|
|
54
|
+
WHEN {action}
|
|
55
|
+
THEN {expected outcome}
|
|
56
|
+
|
|
57
|
+
---
|
|
58
|
+
|
|
59
|
+
## Scope
|
|
60
|
+
|
|
61
|
+
### In Scope
|
|
62
|
+
|
|
63
|
+
- {những gì feature này làm}
|
|
64
|
+
|
|
65
|
+
### Out of Scope
|
|
66
|
+
|
|
67
|
+
- {những gì liên quan nhưng không làm — lý do}
|
|
68
|
+
|
|
69
|
+
## Dependencies
|
|
70
|
+
|
|
71
|
+
| Feature | Loại | Ghi chú |
|
|
72
|
+
| --- | --- | --- |
|
|
73
|
+
| {feature-name} | required before / parallel | {lý do} |
|
|
@@ -0,0 +1,53 @@
|
|
|
1
|
+
---
|
|
2
|
+
id: prd
|
|
3
|
+
type: prd
|
|
4
|
+
status: draft
|
|
5
|
+
owner: "{PM/BA}"
|
|
6
|
+
project_name: "{tên dự án}"
|
|
7
|
+
referenced_by:
|
|
8
|
+
- conventions.md > 3. Main Artifacts > 3.1 Product level > prd.md > Cấu trúc
|
|
9
|
+
- skills/spec-prd/SKILL.md > Process > Bước 1: Kiểm tra preconditions
|
|
10
|
+
- skills/spec-prd/SKILL.md > Process > Bước 3: Write — sinh nội dung
|
|
11
|
+
---
|
|
12
|
+
|
|
13
|
+
# Product Requirements Document
|
|
14
|
+
|
|
15
|
+
## Problem Statement
|
|
16
|
+
|
|
17
|
+
Vấn đề mà hệ thống giải quyết — viết từ góc nhìn business, 2-3 câu.
|
|
18
|
+
Tại sao cần giải quyết bây giờ.
|
|
19
|
+
|
|
20
|
+
## Target Users
|
|
21
|
+
|
|
22
|
+
| Persona | Mục tiêu | Pain Point hiện tại |
|
|
23
|
+
| --- | --- | --- |
|
|
24
|
+
| {tên persona} | {goal chính} | {khó khăn đang gặp} |
|
|
25
|
+
|
|
26
|
+
## Scope
|
|
27
|
+
|
|
28
|
+
### In Scope
|
|
29
|
+
|
|
30
|
+
- {những gì hệ thống sẽ làm}
|
|
31
|
+
|
|
32
|
+
### Out of Scope
|
|
33
|
+
|
|
34
|
+
- {item} — {lý do}
|
|
35
|
+
|
|
36
|
+
## Features
|
|
37
|
+
|
|
38
|
+
| ID | Feature | Mô tả | Priority | Status |
|
|
39
|
+
| --- | --- | --- | --- | --- |
|
|
40
|
+
| F-001 | {tên feature} | {mô tả ngắn — feature làm gì, cho ai} | High/Medium/Low | TODO/DONE |
|
|
41
|
+
|
|
42
|
+
## Non-Functional Requirements
|
|
43
|
+
|
|
44
|
+
| ID | Category | Requirement | Target | Priority |
|
|
45
|
+
| --- | --- | --- | --- | --- |
|
|
46
|
+
| NFR-P01 | Performance | {requirement} | {target đo được} | High/Medium/Low |
|
|
47
|
+
| NFR-SE01 | Security | {requirement} | {target} | High/Medium/Low |
|
|
48
|
+
| NFR-A01 | Availability | {requirement} | {target} | High/Medium/Low |
|
|
49
|
+
|
|
50
|
+
## Business Constraints
|
|
51
|
+
|
|
52
|
+
- {ràng buộc kinh doanh} — constraint
|
|
53
|
+
- {giả định quan trọng} — assumption
|
|
@@ -0,0 +1,68 @@
|
|
|
1
|
+
---
|
|
2
|
+
id: sad
|
|
3
|
+
type: sad
|
|
4
|
+
status: draft
|
|
5
|
+
owner: "{Tech Lead / Architect}"
|
|
6
|
+
referenced_by:
|
|
7
|
+
- conventions.md > 3. Main Artifacts > 3.1 Product level > sad.md > Cấu trúc
|
|
8
|
+
- skills/spec-sad/SKILL.md > Process > Bước 1: Kiểm tra preconditions
|
|
9
|
+
- skills/spec-sad/SKILL.md > Process > Bước 3: Write — sinh draft
|
|
10
|
+
---
|
|
11
|
+
|
|
12
|
+
# System Architecture Document
|
|
13
|
+
|
|
14
|
+
## Architectural Style
|
|
15
|
+
|
|
16
|
+
{Monolith / Microservices / Event-driven / ...} — lý do chọn.
|
|
17
|
+
|
|
18
|
+
## System Overview
|
|
19
|
+
|
|
20
|
+
Các component chính và mối quan hệ giữa chúng.
|
|
21
|
+
|
|
22
|
+
```mermaid
|
|
23
|
+
graph TD
|
|
24
|
+
...
|
|
25
|
+
```
|
|
26
|
+
|
|
27
|
+
## Tech Stack
|
|
28
|
+
|
|
29
|
+
| Layer | Technology | Lý do chọn |
|
|
30
|
+
| --- | --- | --- |
|
|
31
|
+
| Frontend | {tech} | {lý do} |
|
|
32
|
+
| Backend | {tech} | {lý do} |
|
|
33
|
+
| Database | {tech} | {lý do} |
|
|
34
|
+
| Infrastructure | {tech} | {lý do} |
|
|
35
|
+
|
|
36
|
+
## Cross-Cutting Concerns
|
|
37
|
+
|
|
38
|
+
Các quyết định kỹ thuật áp dụng xuyên suốt toàn hệ thống — mọi feature/service đều phải tuân theo. Quyết định một lần tại đây thay vì để từng feature tự diễn giải.
|
|
39
|
+
|
|
40
|
+
- **Authentication & Authorization:** {strategy}
|
|
41
|
+
- **Error Handling:** {pattern}
|
|
42
|
+
- **Logging & Monitoring:** {approach}
|
|
43
|
+
- **Caching:** {strategy}
|
|
44
|
+
|
|
45
|
+
## Inter-Service Communication
|
|
46
|
+
|
|
47
|
+
*(Diagram tùy chọn — hữu ích khi số lượng service ít)*
|
|
48
|
+
|
|
49
|
+
```mermaid
|
|
50
|
+
graph LR
|
|
51
|
+
...
|
|
52
|
+
```
|
|
53
|
+
|
|
54
|
+
| From | To | Method | Protocol | Notes |
|
|
55
|
+
| --- | --- | --- | --- | --- |
|
|
56
|
+
| {source} | {target} | sync/async | REST/event/gRPC | {ghi chú} |
|
|
57
|
+
|
|
58
|
+
## Infrastructure Overview
|
|
59
|
+
|
|
60
|
+
{Môi trường (dev/staging/prod), deployment strategy, provider.}
|
|
61
|
+
|
|
62
|
+
## Architectural Guardrails
|
|
63
|
+
|
|
64
|
+
Các nguyên tắc sau là bất biến. Agent phải kiểm tra compliance trước khi finalize `tech.md`.
|
|
65
|
+
|
|
66
|
+
- GUARD-001: {nguyên tắc — ví dụ: Không dùng raw SQL, phải qua ORM}
|
|
67
|
+
- GUARD-002: {nguyên tắc — ví dụ: Mọi external API call phải có retry + timeout}
|
|
68
|
+
- GUARD-003: {nguyên tắc — ví dụ: Không để business logic trong API layer}
|