sedd 0.1.12 → 0.1.13

package/commands/sedd.clarify.md

@@ -316,7 +316,20 @@ Ao gerar tasks, VARRER clarify.md por TODOS os `[TASK_SOURCE:*]` tags:
 - Cada tag com tipo `edge-case` → task de validacao/protecao
 - Cada tag com tipo `constraint` → task de teste negativo
 
-Based on all decisions and TASK_SOURCE tags, create tasks:
+Based on all decisions and TASK_SOURCE tags, **use the CLI to add tasks**:
+
+```bash
+sedd tasks '[{"story":"Foundation","description":"Create ThemeContext in src/contexts/ThemeContext.tsx"},{"story":"Foundation","description":"Add theme column to users table prisma/schema.prisma"},{"story":"US1","description":"Create ThemeToggle component src/components/ThemeToggle.tsx"},{"story":"US1","description":"Add toggle to settings page src/pages/settings.tsx"},{"story":"US1","description":"Implement theme API endpoint src/api/user/theme.ts"}]'
+```
+
+This automatically:
+- Appends tasks to `tasks.md` with correct IDs (T001-001, T001-002...)
+- Updates `_meta.json` (tasksTotal, status → in-progress)
+- Creates GitHub issues for each task (if GitHub integration is configured)
+
+**Do NOT manually write tasks.md** — the CLI handles file creation and GitHub sync.
+
+The CLI generates `tasks.md` with this structure:
 
 ```markdown
 # Tasks - Migration 001
@@ -335,7 +348,11 @@ Total: 5 | Completed: 0 | Pending: 5
 - [ ] T001-003 [US1] Create ThemeToggle component `src/components/ThemeToggle.tsx`
 - [ ] T001-004 [US1] Add toggle to settings page `src/pages/settings.tsx`
 - [ ] T001-005 [US1] Implement theme API endpoint `src/api/user/theme.ts`
+```
 
+After adding tasks via CLI, manually add the `## Dependencies` section to tasks.md:
+
+```markdown
 ## Dependencies
 
 T001-001, T001-002 → T001-003 → T001-004

package/commands/sedd.implement.md

@@ -114,28 +114,26 @@ For each task in order:
 
 3. **Execute the task**
 
-4. **Update ALL task files** (CRITICAL - keep them in sync):
+4. **Mark task as completed using CLI** (CRITICAL - syncs with GitHub automatically):
 
-   a. **Update tasks.md** in migration folder - change `[ ]` to `[x]`:
-   ```markdown
-   # Before
-   - [ ] T001-001 [Foundation] Create ThemeContext
-
-   # After
-   - [x] T001-001 [Foundation] Create ThemeContext
+   ```bash
+   sedd complete T001-001
    ```
 
-   b. **Update progress.md** - mark completed with timestamp:
+   This automatically:
+   - Updates `tasks.md` (`[ ]` → `[x]`)
+   - Increments `tasksCompleted` in `_meta.json`
+   - If GitHub integration is configured:
+     - Moves the issue to "Done" on the project board
+     - Comments on the issue with progress
+     - When all tasks complete: closes the source issue
+
+   After running `sedd complete`, also update **progress.md** manually:
    ```markdown
    - [x] T001-001 [10:30 → 10:45] Create ThemeContext
    ```
 
-   c. **Update _meta.json** - increment tasksCompleted:
-   ```json
-   "tasksCompleted": 1
-   ```
-
-5. **Verify sync** - All three files must show same completed count
+5. **Verify sync** - tasks.md, _meta.json and progress.md must show same completed count
 
 ### Step 5.6: Validate Against Expectations (CRITICAL - Before Marking Done)
 
@@ -610,10 +608,8 @@ Stops after migration 002.
 
 ## Rules
 
-- **CRITICAL: Update ALL 3 files when completing a task:**
-  1. `{migration}/tasks.md` - change `[ ]` to `[x]`
-  2. `progress.md` - mark task with `[x]` and timestamps
-  3. `_meta.json` - increment tasksCompleted count
+- **CRITICAL: Use `sedd complete <task-id>` to mark tasks done** (syncs tasks.md, _meta.json, and GitHub automatically)
+  - Then manually update `progress.md` with timestamps
 - ONE task in-progress at a time
 - **With `--all` flag:** NO prompts between migrations, commit only at end
 - **Without flag:** Ask about commit after each migration completes
@@ -623,11 +619,12 @@ Stops after migration 002.
 
 ## File Sync Checklist
 
-After completing each task, verify:
+After running `sedd complete T001-001`, verify:
 ```
-✓ tasks.md      → - [x] T001-001 ...
-✓ progress.md   → - [x] T001-001 [time] ...
-✓ _meta.json    → "tasksCompleted": N
+✓ tasks.md      → - [x] T001-001 ...  (auto by sedd complete)
+✓ _meta.json    → "tasksCompleted": N  (auto by sedd complete)
+✓ progress.md   → - [x] T001-001 [time] ...  (manual update)
+✓ GitHub issue   → moved to Done column  (auto if configured)
 ```
 
 If files are out of sync, fix immediately before continuing.

package/commands/sedd.tasks.md

@@ -75,9 +75,21 @@ T002-001 = Migration 002, Task 1
 | Integration | External services |
 | Tests | Unit, integration tests |
 
-### Step 5: Write tasks.md
+### Step 5: Add tasks via CLI
 
-Append to `{currentMigration}/tasks.md`:
+**CRITICAL:** Use the `sedd tasks` CLI command to add tasks. This automatically:
+- Appends tasks to `tasks.md` with correct IDs
+- Updates `_meta.json` (tasksTotal, status)
+- Creates GitHub issues for each task (if GitHub integration is configured)
+- Checks WIP limits on the board
+
+```bash
+sedd tasks '[{"story":"Foundation","description":"Create database migration for new tables"},{"story":"Foundation","description":"Set up API route structure"},{"story":"US1","description":"Create ThemeContext with localStorage persistence"},{"story":"US1","description":"Build ThemeToggle component"},{"story":"US1","description":"Add toggle to settings page"},{"story":"US2","description":"Create user preference API endpoint"},{"story":"US2","description":"Implement cross-device sync"},{"story":"Tests","description":"Write unit tests for ThemeContext"}]'
+```
+
+**Do NOT manually edit tasks.md or _meta.json** — the CLI handles both and syncs with GitHub.
+
+The CLI generates `tasks.md` with this structure:
 
 ```markdown
 # Tasks - Migration 001
@@ -106,7 +118,11 @@ Total: 8 | Completed: 0 | Pending: 8
 
 ### Tests
 - [ ] T001-008 [Tests] Write unit tests for ThemeContext
+```
+
+After adding tasks via CLI, manually add the `## Dependencies` section to tasks.md:
 
+```markdown
 ## Dependencies
 
 T001-001, T001-002 → T001-003 → T001-004 → T001-005
@@ -116,6 +132,8 @@ T001-003 → T001-008
 
 ### Step 6: Update _meta.json
 
+The CLI also updates `_meta.json` automatically:
+
 ```json
 {
   "migrations": {

package/commands/sedd.validate.md

@@ -285,11 +285,17 @@ Próximo passo: Reverter alterações que violam restrições.
 
 ### Step 8: Create Follow-up Tasks (if gaps)
 
-If gaps found and `--auto` flag or user confirms:
+If gaps found and `--auto` flag or user confirms, **use the CLI to add tasks**:
 
-```markdown
-# New tasks added to tasks.md
+```bash
+sedd tasks '[{"story":"Follow-up","description":"Implement session persistence for theme"},{"story":"Follow-up","description":"Add session storage fallback"}]'
+```
 
+This automatically creates GitHub issues for the follow-up tasks and updates _meta.json.
+**Do NOT manually append to tasks.md** — use the CLI.
+
+The CLI will add to tasks.md:
+```markdown
 - [ ] T001-NEW-001 [Follow-up] Implement session persistence for theme
 - [ ] T001-NEW-002 [Follow-up] Add session storage fallback
 ```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sedd",
-  "version": "0.1.12",
+  "version": "0.1.13",
   "description": "SEDD - Spec & Expectation Driven Development. A phase-based specification workflow for AI-assisted development.",
   "type": "module",
   "main": "dist/index.js",