690414:1113 Update README.md /.agents/skills, /.windsurf/workflows

2026-04-14 11:13:42 +07:00
parent 02400fd88c
commit 6d45bdaeb5
194 changed files with 12708 additions and 8762 deletions
@@ -1,4 +1,5 @@
 ---
+auto_execution_mode: 0
 description: Run the full speckit pipeline from specification to analysis in one command.
 ---

@@ -1,4 +1,5 @@
 ---
+auto_execution_mode: 0
 description: Create or update the project constitution from interactive or provided principle inputs, ensuring all dependent templates stay in sync.
 ---

@@ -1,4 +1,5 @@
 ---
+auto_execution_mode: 0
 description: Create or update the feature specification from a natural language feature description.
 ---

@@ -1,4 +1,5 @@
 ---
+auto_execution_mode: 0
 description: Identify underspecified areas in the current feature spec by asking up to 5 highly targeted clarification questions and encoding answers back into the spec.
 ---

@@ -1,4 +1,5 @@
 ---
+auto_execution_mode: 0
 description: Execute the implementation planning workflow using the plan template to generate design artifacts.
 ---

@@ -1,4 +1,5 @@
 ---
+auto_execution_mode: 0
 description: Generate an actionable, dependency-ordered tasks.md for the feature based on available design artifacts.
 ---

@@ -1,4 +1,5 @@
 ---
+auto_execution_mode: 0
 description: Perform a non-destructive cross-artifact consistency and quality analysis across spec.md, plan.md, and tasks.md after task generation.
 ---

@@ -1,4 +1,5 @@
 ---
+auto_execution_mode: 0
 description: Execute the implementation plan by processing and executing all tasks defined in tasks.md
 ---

@@ -1,4 +1,5 @@
 ---
+auto_execution_mode: 0
 description: Run static analysis tools and aggregate results.
 ---

@@ -1,4 +1,5 @@
 ---
+auto_execution_mode: 0
 description: Execute tests, measure coverage, and report results.
 ---

@@ -1,4 +1,5 @@
 ---
+auto_execution_mode: 0
 description: Perform code review with actionable feedback and suggestions.
 ---

@@ -1,4 +1,5 @@
 ---
+auto_execution_mode: 0
 description: Validate that implementation matches specification requirements.
 ---

@@ -1,4 +1,5 @@
 ---
+auto_execution_mode: 0
 description: Create a new NestJS backend feature module following project standards
 ---

@@ -13,7 +14,7 @@ Follows `specs/05-Engineering-Guidelines/05-02-backend-guidelines.md` and ADR-00

 1. **Verify requirements exist** — confirm the feature is in `specs/01-Requirements/` before starting

-// turbo 2. **Check schema** — read `specs/03-Data-and-Storage/lcbp3-v1.7.0-schema.sql` for relevant tables
+// turbo 2. **Check schema** — read `specs/03-Data-and-Storage/lcbp3-v1.8.0-schema.sql` for relevant tables

 3. **Scaffold module folder**

@@ -30,17 +31,17 @@ backend/src/modules/<module-name>/
 └── <module-name>.controller.spec.ts
 ```

-4. **Create Entity** — map ONLY columns defined in the schema SQL. Use TypeORM decorators. Add `@VersionColumn()` if the entity needs optimistic locking.
+// turbo 4. **Create Entity** — map ONLY columns defined in the schema SQL. Use TypeORM decorators. Add `@VersionColumn()` if the entity needs optimistic locking.

-5. **Create DTOs** — use `class-validator` decorators. Never use `any`. Validate all inputs.
+// turbo 5. **Create DTOs** — use `class-validator` decorators. Never use `any`. Validate all inputs.

-6. **Create Service** — inject repository via constructor DI. Use transactions for multi-step writes. Add `Idempotency-Key` guard for POST/PUT/PATCH operations.
+// turbo 6. **Create Service** — inject repository via constructor DI. Use transactions for multi-step writes. Add `Idempotency-Key` guard for POST/PUT/PATCH operations.

-7. **Create Controller** — apply `@UseGuards(JwtAuthGuard, CaslAbilityGuard)`. Use proper HTTP status codes. Document with `@ApiTags` and `@ApiOperation`.
+// turbo 7. **Create Controller** — apply `@UseGuards(JwtAuthGuard, CaslAbilityGuard)`. Use proper HTTP status codes. Document with `@ApiTags` and `@ApiOperation`.

-8. **Register in Module** — add to `imports`, `providers`, `controllers`, `exports` as needed.
+// turbo 8. **Register in Module** — add to `imports`, `providers`, `controllers`, `exports` as needed.

-9. **Register in AppModule** — import the new module in `app.module.ts`.
+// turbo 9. **Register in AppModule** — import the new module in `app.module.ts`.

 // turbo 10. **Write unit test** — cover service methods with Jest mocks. Run:

@@ -1,4 +1,5 @@
 ---
+auto_execution_mode: 0
 description: Create a new Next.js App Router page following project standards
 ---

@@ -1,4 +1,5 @@
 ---
+auto_execution_mode: 0
 description: Deploy the application via Gitea Actions to QNAP Container Station
 ---

@@ -1,4 +1,5 @@
 ---
+auto_execution_mode: 0
 description: Manage database schema changes following ADR-009 (no migrations, modify SQL directly)
 ---

@@ -18,7 +19,7 @@ Follows `specs/06-Decision-Records/ADR-009-database-strategy.md` — **NO TypeOR
 1. **Read current schema** — load the full schema file:

 ```
-specs/03-Data-and-Storage/lcbp3-v1.7.0-schema.sql
+specs/03-Data-and-Storage/lcbp3-v1.8.0-schema.sql
 ```

 2. **Read data dictionary** — understand current field definitions:
@@ -35,7 +36,7 @@ specs/03-Data-and-Storage/03-01-data-dictionary.md
 - Indexes being added/modified
 - Seed data impact (if any)

-4. **Modify schema SQL** — edit `specs/03-Data-and-Storage/lcbp3-v1.7.0-schema.sql`:
+4. **Modify schema SQL** — edit `specs/03-Data-and-Storage/lcbp3-v1.8.0-schema.sql`:
   - Add/modify table definitions
   - Maintain consistent formatting (uppercase SQL keywords, lowercase identifiers)
   - Add inline comments for new columns explaining purpose
@@ -52,8 +53,8 @@ specs/03-Data-and-Storage/03-01-data-dictionary.md
   - Add enum value definitions if applicable

 6. **Update seed data** (if applicable):
-   - `specs/03-Data-and-Storage/lcbp3-v1.7.0-seed-basic.sql` — for reference/lookup data
-   - `specs/03-Data-and-Storage/lcbp3-v1.7.0-seed-permissions.sql` — for new CASL permissions
+   - `specs/03-Data-and-Storage/lcbp3-v1.8.0-seed-basic.sql` — for reference/lookup data
+   - `specs/03-Data-and-Storage/lcbp3-v1.8.0-seed-permissions.sql` — for new CASL permissions

 7. **Update TypeORM entity** — modify corresponding `backend/src/modules/<module>/entities/*.entity.ts`:
   - Map ONLY columns defined in schema SQL
@@ -1,4 +1,5 @@
 ---
+auto_execution_mode: 0
 description: Execute the full preparation pipeline (Specify -> Clarify -> Plan -> Tasks -> Analyze) in sequence.
 ---

@@ -1,4 +1,5 @@
 ---
+auto_execution_mode: 0
 description: Generate a custom checklist for the current feature based on user requirements.
 ---

@@ -1,4 +1,5 @@
 ---
+auto_execution_mode: 0
 description: Compare two versions of a spec or plan to highlight changes.
 ---

@@ -1,4 +1,5 @@
 ---
+auto_execution_mode: 0
 description: Migrate existing projects into the speckit structure by generating spec.md, plan.md, and tasks.md from existing code.
 ---

@@ -1,4 +1,5 @@
 ---
+auto_execution_mode: 0
 description: Challenge the specification with Socratic questioning to identify logical gaps, unhandled edge cases, and robustness issues.
 ---

@@ -1,4 +1,5 @@
 ---
+auto_execution_mode: 0
 description: Display a dashboard showing feature status, completion percentage, and blockers.
 ---

@@ -1,18 +0,0 @@
---
-description: Convert existing tasks into actionable, dependency-ordered GitHub issues for the feature based on available design artifacts.
---
-
-# Workflow: speckit.taskstoissues
-
-1. **Context Analysis**:
-   - The user has provided an input prompt. Treat this as the primary input for the skill.
-
-2. **Load Skill**:
-   - Use the `view_file` tool to read the skill file at: `.agents/skills/speckit.taskstoissues/SKILL.md`
-
-3. **Execute**:
-   - Follow the instructions in the `SKILL.md` exactly.
-   - Apply the user's prompt as the input arguments/context for the skill's logic.
-
-4. **On Error**:
-   - If `tasks.md` is missing: Run `/speckit.tasks` first