@tungvivas/angular-vibe-kit 0.1.0 → 0.3.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,29 @@
1
+ # SRS (source requirements)
2
+
3
+ Drop your **already-split** SRS excerpts here — one file per module/feature, not the whole
4
+ multi-module document. If your SRS is a Word doc converted via `pandoc` into one large Markdown
5
+ file with an images folder, extract just the section you're about to build and save it here,
6
+ keeping any image references relative and valid.
7
+
8
+ ## Convention
9
+
10
+ ```
11
+ docs/srs/
12
+ ├── module-5-order-management.md
13
+ ├── module-6-invoicing.md
14
+ └── images/ # keep paths relative to match what pandoc generated
15
+ ```
16
+
17
+ ## Usage
18
+
19
+ This folder is **not** auto-read — `/plan` doesn't scan it on its own. Point to the file
20
+ explicitly when you start planning:
21
+
22
+ ```
23
+ /plan
24
+
25
+ Đọc yêu cầu từ docs/srs/module-5-order-management.md
26
+ ```
27
+
28
+ Keep these files committed — they're the record of what was actually asked for each module,
29
+ useful when a later module needs to know how an earlier one was scoped.
@@ -49,11 +49,27 @@ When guidance conflicts, follow this order top to bottom:
49
49
  ## Coding Rules
50
50
  > /init will generate concrete rules based on Angular version + what the project does.
51
51
 
52
+ ## Component Wrapper Priority
53
+ - ALWAYS check `docs/DESIGN_SYSTEM.md` → **Wrapped Components** before importing a UI library
54
+ - If a wrapper exists for the need → import the wrapper (e.g. `import { AppSelectComponent } from '@shared/components/select'`), NEVER the raw library (`p-dropdown`)
55
+ - If no wrapper exists → use the library directly and log a warning to the user: `> ⚠️ No wrapper for <X> — using library directly. Consider creating one in shared/components/`
56
+ - If unsure whether a wrapper exists → ASK the team before writing the import
57
+ - This rule is enforced by `/review-pr` (🔴 BLOCKER if violated in new code)
58
+
52
59
  ## DO NOT
53
60
  - Do NOT use `any`
54
61
  - Do NOT call HttpClient from components
55
62
  - Do NOT store tokens in localStorage
56
63
  - Do NOT hardcode the backend URL
64
+ - Do NOT import UI library components directly in features when a wrapper exists in `shared/components/`
65
+
66
+ ## Commit Convention
67
+ > Read by the `git-commit` skill and the `angular-git-workflow` agent. /init fills this from `git log`.
68
+ - **Prefix**: {{none}} <!-- prepended before <type>, e.g. "VIVAS_"; default: none -->
69
+ - **Language**: {{vi}} <!-- subject/body language for commits AND /explain output; default: vi -->
70
+ - **Format**: `<prefix><type>(<scope>): <subject>`
71
+ - **Scope source**: top-level folder under {{src/app/features | src/app/modules | ...}} of the changed files; multiple modules → omit scope
72
+ - **Types**: feat, fix, refactor, docs, style, test, chore, perf, ci, build, revert
57
73
 
58
74
  ## Reference Examples
59
75
  > /init fills this with the best existing files to copy patterns from.