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.
@@ -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}