@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.
- package/README.md +165 -12
- package/agents/angular-a11y-auditor.md +71 -0
- package/agents/angular-build-fixer.md +37 -0
- package/agents/angular-debugger.md +38 -0
- package/agents/angular-git-workflow.md +46 -0
- package/agents/angular-onboarding.md +56 -0
- package/agents/angular-reviewer.md +22 -0
- package/agents/angular-test-writer.md +26 -0
- package/agents/angular-ui-designer.md +55 -0
- package/bin/cli.js +131 -5
- package/commands/dev-cycle.md +44 -12
- package/commands/init.md +27 -6
- package/commands/new-feature.md +23 -43
- package/commands/plan.md +136 -0
- package/commands/review-pr.md +12 -63
- package/commands/write-context.md +6 -0
- package/commands/write-tests.md +9 -107
- package/package.json +9 -3
- package/references/feature-structure.md +44 -0
- package/references/plan-spec.md +112 -0
- package/references/review-checklist.md +88 -0
- package/references/test-spec.md +92 -0
- package/skills/angular-practices/SKILL.md +34 -0
- package/skills/clarify-request/SKILL.md +100 -0
- package/skills/component-wrapper-priority/SKILL.md +38 -0
- package/skills/explain/SKILL.md +102 -0
- package/skills/explain/templates/vi.md +184 -0
- package/skills/git-commit/SKILL.md +107 -0
- package/skills/git-commit/references/conventions.md +100 -0
- package/templates/docs/DESIGN_SYSTEM.md +21 -0
- package/templates/docs/srs/README.md +29 -0
- package/templates/rules/project-rules.md +16 -0
|
@@ -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.
|