@wipcomputer/wip-ai-devops-toolbox 1.9.40 → 1.9.41

package/CHANGELOG.md

@@ -31,6 +31,27 @@
 
 
 
+
+## 1.9.41 (2026-03-17)
+
+# Doc enforcement gates for wip-release
+
+**Date:** 2026-03-16
+**Closes:** #117, #128
+
+## What changed
+
+Two new pre-release gates in wip-release:
+
+**Technical Docs Gate (#117):** When source code (*.mjs, *.js, *.ts) changed since the last release tag, checks that SKILL.md or TECHNICAL.md was also modified. Catches code shipping without doc updates. Warns on patch, blocks on minor/major. Skip with `--skip-tech-docs-check`.
+
+**Interface Coverage Gate (#128):** For toolbox repos, scans each tool in tools/*/ for actual interfaces (CLI, Module, MCP, OC Plugin, Skill, CC Hook) and compares to the coverage table in README.md and SKILL.md. Reports: tools missing from table, interfaces detected but not marked Y, interfaces marked Y but not detected, tool count mismatches. Warns on patch, blocks on minor/major. Skip with `--skip-coverage-check`.
+
+Both follow the same pattern as existing gates (checkProductDocs, checkStaleBranches). Both run in real and dry-run modes.
+
+## Why
+
+Source code was shipping without doc updates constantly. SKILL.md and TECHNICAL.md fell behind the code. Interface coverage tables drifted from reality. These gates catch it before release instead of after.
 
 ## 1.9.40 (2026-03-16)
 

package/SKILL.md

@@ -5,7 +5,7 @@ license: MIT
 interface: [cli, module, mcp, skill, hook, plugin]
 metadata:
   display-name: "WIP AI DevOps Toolbox"
-  version: "1.9.40"
+  version: "1.9.41"
   homepage: "https://github.com/wipcomputer/wip-ai-devops-toolbox"
   author: "Parker Todd Brooks"
   category: dev-tools

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wipcomputer/wip-ai-devops-toolbox",
-  "version": "1.9.40",
+  "version": "1.9.41",
   "type": "module",
   "description": "The complete AI DevOps toolkit for AI-assisted development teams.",
   "license": "MIT",

package/tools/deploy-public/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wipcomputer/deploy-public",
-  "version": "1.9.40",
+  "version": "1.9.41",
   "description": "Private-to-public repo sync. Excludes ai/ folder, creates PR, merges, cleans up branches.",
   "bin": {
     "deploy-public": "./deploy-public.sh"

package/tools/post-merge-rename/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wipcomputer/post-merge-rename",
-  "version": "1.9.40",
+  "version": "1.9.41",
   "description": "Post-merge branch renaming. Appends --merged-YYYY-MM-DD to preserve history.",
   "bin": {
     "post-merge-rename": "./post-merge-rename.sh"

package/tools/wip-branch-guard/guard.mjs

@@ -7,7 +7,7 @@
 
 import { execSync } from 'node:child_process';
 import { dirname, join } from 'node:path';
-import { statSync, readFileSync } from 'node:fs';
+import { statSync, readFileSync, existsSync } from 'node:fs';
 import { fileURLToPath } from 'node:url';
 
 if (process.argv.includes('--version') || process.argv.includes('-v')) {
@@ -186,6 +186,23 @@ async function main() {
       deny('BLOCKED: git push --force can destroy remote history. Use --force-with-lease or ask Parker.');
       process.exit(0);
     }
+
+    // Block npm install -g right after a release (#73)
+    // wip-release writes ~/.ldm/state/.last-release on completion.
+    // If a release happened < 5 minutes ago, block install unless user explicitly said "install".
+    if (/\bnpm\s+install\s+-g\b/.test(cmd)) {
+      try {
+        const releasePath = join(process.env.HOME || '', '.ldm', 'state', '.last-release');
+        if (existsSync(releasePath)) {
+          const data = JSON.parse(readFileSync(releasePath, 'utf8'));
+          const age = Date.now() - new Date(data.timestamp).getTime();
+          if (age < 5 * 60 * 1000) { // 5 minutes
+            deny(`BLOCKED: Release completed ${Math.round(age / 1000)}s ago. Dogfood first. Remove ~/.ldm/state/.last-release when ready to install.`);
+            process.exit(0);
+          }
+        }
+      } catch {}
+    }
   }
 
   // Determine which repo to check.

package/tools/wip-branch-guard/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wipcomputer/wip-branch-guard",
-  "version": "1.9.40",
+  "version": "1.9.41",
   "description": "PreToolUse hook that blocks all writes on main branch. Forces agents to work on branches or worktrees.",
   "type": "module",
   "main": "guard.mjs",

package/tools/wip-file-guard/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wipcomputer/wip-file-guard",
-  "version": "1.9.40",
+  "version": "1.9.41",
   "type": "module",
   "description": "Hook that blocks destructive edits to protected identity files. For Claude Code CLI and OpenClaw.",
   "main": "guard.mjs",

package/tools/wip-license-guard/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wipcomputer/wip-license-guard",
-  "version": "1.9.40",
+  "version": "1.9.41",
   "description": "License compliance for your own repos. Ensures correct copyright, dual-license blocks, and LICENSE files.",
   "type": "module",
   "bin": {

package/tools/wip-license-hook/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wipcomputer/wip-license-hook",
-  "version": "1.9.40",
+  "version": "1.9.41",
   "description": "License rug-pull detection and dependency license compliance for open source projects",
   "type": "module",
   "main": "dist/cli/index.js",

package/tools/wip-readme-format/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wipcomputer/wip-readme-format",
-  "version": "1.9.40",
+  "version": "1.9.41",
   "description": "Reformat any repo's README to follow the WIP Computer standard. Agent-first, human-readable.",
   "type": "module",
   "bin": {

package/tools/wip-release/cli.js

@@ -21,6 +21,8 @@ const noPublish = args.includes('--no-publish');
 const skipProductCheck = args.includes('--skip-product-check');
 const skipStaleCheck = args.includes('--skip-stale-check');
 const skipWorktreeCheck = args.includes('--skip-worktree-check');
+const skipTechDocsCheck = args.includes('--skip-tech-docs-check');
+const skipCoverageCheck = args.includes('--skip-coverage-check');
 const notesFilePath = flag('notes-file');
 let notes = flag('notes');
 // Bug fix #121: use strict check, not truthiness. --notes="" is empty, not absent.
@@ -164,6 +166,8 @@ release({
   skipProductCheck,
   skipStaleCheck,
   skipWorktreeCheck,
+  skipTechDocsCheck,
+  skipCoverageCheck,
 }).catch(err => {
   console.error(`  ✗ ${err.message}`);
   process.exit(1);

package/tools/wip-release/core.mjs

@@ -383,6 +383,194 @@ function checkProductDocs(repoPath) {
   return { missing, ok: missing.length === 0, skipped: false };
 }
 
+/**
+ * Check that technical docs (SKILL.md, TECHNICAL.md) were updated
+ * when source code changed since last release tag.
+ * Returns { missing: string[], ok: boolean, skipped: boolean }.
+ */
+function checkTechnicalDocs(repoPath) {
+  try {
+    let lastTag;
+    try {
+      lastTag = execFileSync('git', ['describe', '--tags', '--abbrev=0'],
+        { cwd: repoPath, encoding: 'utf8' }).trim();
+    } catch {
+      return { missing: [], ok: true, skipped: true }; // No tags yet
+    }
+
+    const diff = execFileSync('git', ['diff', '--name-only', lastTag, 'HEAD'],
+      { cwd: repoPath, encoding: 'utf8' });
+    const changedFiles = diff.split('\n').map(f => f.trim()).filter(Boolean);
+
+    // Find source code changes (*.mjs, *.js, *.ts) excluding non-source dirs
+    const excludePattern = /\/(node_modules|dist|_trash|examples)\//;
+    const sourcePattern = /\.(mjs|js|ts)$/;
+    const sourceChanges = changedFiles.filter(f =>
+      sourcePattern.test(f) && !excludePattern.test(f) && !f.startsWith('ai/')
+    );
+
+    if (sourceChanges.length === 0) {
+      return { missing: [], ok: true, skipped: false }; // No source changes
+    }
+
+    // Check if any doc files were also modified
+    const docChanges = changedFiles.filter(f =>
+      f === 'SKILL.md' || f === 'TECHNICAL.md' ||
+      /^tools\/[^/]+\/SKILL\.md$/.test(f) ||
+      /^tools\/[^/]+\/TECHNICAL\.md$/.test(f)
+    );
+
+    if (docChanges.length > 0) {
+      return { missing: [], ok: true, skipped: false }; // Docs updated
+    }
+
+    // Source changed but no doc updates
+    const missing = [];
+    const preview = sourceChanges.slice(0, 5).join(', ');
+    const more = sourceChanges.length > 5 ? ` (and ${sourceChanges.length - 5} more)` : '';
+    missing.push('Source files changed since last tag but no SKILL.md or TECHNICAL.md was updated');
+    missing.push(`Changed: ${preview}${more}`);
+    missing.push('Update SKILL.md or TECHNICAL.md to document these changes');
+
+    return { missing, ok: false, skipped: false };
+  } catch {
+    return { missing: [], ok: true, skipped: true }; // Graceful fallback
+  }
+}
+
+/**
+ * Parse the interface coverage table from a markdown file.
+ * Returns array of { name, cli, module, mcp, openclaw, skill, ccHook } or null.
+ */
+function parseInterfaceCoverageTable(filePath) {
+  if (!existsSync(filePath)) return null;
+  const content = readFileSync(filePath, 'utf8');
+  const lines = content.split('\n');
+
+  const headerIdx = lines.findIndex(l => /^\|\s*#\s*\|\s*Tool\s*\|/i.test(l));
+  if (headerIdx === -1) return null;
+
+  const rows = [];
+  for (let i = headerIdx + 2; i < lines.length; i++) {
+    const line = lines[i].trim();
+    if (!line.startsWith('|')) break;
+    const cells = line.split('|').map(c => c.trim()).filter(c => c !== '');
+    if (cells.length < 8) continue;
+    // Skip category header rows (# cell is empty, non-numeric, or bold)
+    const num = cells[0].trim();
+    if (!num || /^\*\*/.test(num) || isNaN(parseInt(num))) continue;
+    rows.push({
+      name: cells[1].trim(),
+      cli: /^Y$/i.test(cells[2]),
+      module: /^Y$/i.test(cells[3]),
+      mcp: /^Y$/i.test(cells[4]),
+      openclaw: /^Y$/i.test(cells[5]),
+      skill: /^Y$/i.test(cells[6]),
+      ccHook: /^Y$/i.test(cells[7]),
+    });
+  }
+  return rows.length > 0 ? rows : null;
+}
+
+/**
+ * Read display name from a tool's SKILL.md frontmatter.
+ * Tries display-name, then name field. Falls back to null.
+ */
+function getToolDisplayName(toolPath) {
+  const skillPath = join(toolPath, 'SKILL.md');
+  if (!existsSync(skillPath)) return null;
+  try {
+    const content = readFileSync(skillPath, 'utf8');
+    const displayMatch = content.match(/^\s*display-name:\s*"?([^"\n]+)"?/m);
+    if (displayMatch) return displayMatch[1].trim();
+    const nameMatch = content.match(/^name:\s*"?([^"\n]+)"?/m);
+    if (nameMatch) return nameMatch[1].trim();
+  } catch {}
+  return null;
+}
+
+/**
+ * Check that the interface coverage table in README.md and SKILL.md
+ * matches the actual interfaces detected in tools/*/.
+ * Returns { missing: string[], ok: boolean, skipped: boolean }.
+ */
+function checkInterfaceCoverage(repoPath) {
+  try {
+    // Only applies to toolbox repos
+    const toolsDir = join(repoPath, 'tools');
+    if (!existsSync(toolsDir)) return { missing: [], ok: true, skipped: true };
+
+    const entries = readdirSync(toolsDir, { withFileTypes: true });
+    const tools = entries
+      .filter(e => e.isDirectory() && existsSync(join(toolsDir, e.name, 'package.json')))
+      .map(e => ({ name: e.name, path: join(toolsDir, e.name) }));
+
+    if (tools.length === 0) return { missing: [], ok: true, skipped: true };
+
+    // Detect actual interfaces for each tool
+    const actualMap = {};
+    for (const tool of tools) {
+      const pkg = JSON.parse(readFileSync(join(tool.path, 'package.json'), 'utf8'));
+      actualMap[tool.name] = {
+        displayName: getToolDisplayName(tool.path) || tool.name,
+        cli: !!(pkg.bin),
+        module: !!(pkg.main || pkg.exports),
+        mcp: ['mcp-server.mjs', 'mcp-server.js', 'dist/mcp-server.js'].some(f => existsSync(join(tool.path, f))),
+        openclaw: existsSync(join(tool.path, 'openclaw.plugin.json')),
+        skill: existsSync(join(tool.path, 'SKILL.md')),
+        ccHook: !!(pkg.claudeCode?.hook) || existsSync(join(tool.path, 'guard.mjs')),
+      };
+    }
+
+    const missing = [];
+
+    // Check both README.md and SKILL.md tables
+    for (const [label, filePath] of [['README.md', join(repoPath, 'README.md')], ['SKILL.md', join(repoPath, 'SKILL.md')]]) {
+      const tableRows = parseInterfaceCoverageTable(filePath);
+      if (!tableRows) continue;
+
+      // Tool count
+      if (tools.length !== tableRows.length) {
+        missing.push(`${label}: tool count mismatch (${tools.length} in tools/, ${tableRows.length} in table)`);
+      }
+
+      // Check each actual tool against the table
+      for (const tool of tools) {
+        const actual = actualMap[tool.name];
+        const displayName = actual.displayName;
+        const tableRow = tableRows.find(r =>
+          r.name === displayName ||
+          r.name.toLowerCase() === displayName.toLowerCase() ||
+          r.name.toLowerCase().includes(tool.name.replace(/^wip-/, '').replace(/-/g, ' '))
+        );
+
+        if (!tableRow) {
+          missing.push(`${label}: ${tool.name} (${displayName}) missing from coverage table`);
+          continue;
+        }
+
+        const ifaceMap = [
+          ['cli', 'CLI'], ['module', 'Module'], ['mcp', 'MCP'],
+          ['openclaw', 'OC Plugin'], ['skill', 'Skill'], ['ccHook', 'CC Hook']
+        ];
+
+        for (const [key, name] of ifaceMap) {
+          if (actual[key] && !tableRow[key]) {
+            missing.push(`${label}: ${displayName} has ${name} but table says no`);
+          }
+          if (tableRow[key] && !actual[key]) {
+            missing.push(`${label}: ${displayName} marked ${name} in table but not detected`);
+          }
+        }
+      }
+    }
+
+    return { missing, ok: missing.length === 0, skipped: false };
+  } catch {
+    return { missing: [], ok: true, skipped: true }; // Graceful fallback
+  }
+}
+
 /**
  * Auto-update version/date lines in product docs before the release commit.
  * Updates roadmap.md "Current version" and "Last updated",
@@ -818,7 +1006,7 @@ export function checkStaleBranches(repoPath, level) {
 /**
  * Run the full release pipeline.
  */
-export async function release({ repoPath, level, notes, notesSource, dryRun, noPublish, skipProductCheck, skipStaleCheck, skipWorktreeCheck }) {
+export async function release({ repoPath, level, notes, notesSource, dryRun, noPublish, skipProductCheck, skipStaleCheck, skipWorktreeCheck, skipTechDocsCheck, skipCoverageCheck }) {
   repoPath = repoPath || process.cwd();
   const currentVersion = detectCurrentVersion(repoPath);
   const newVersion = bumpSemver(currentVersion, level);
@@ -962,6 +1150,50 @@ export async function release({ repoPath, level, notes, notesSource, dryRun, noP
     }
   }
 
+  // 0.85. Technical docs check
+  if (!skipTechDocsCheck) {
+    const techDocsCheck = checkTechnicalDocs(repoPath);
+    if (!techDocsCheck.skipped) {
+      if (techDocsCheck.ok) {
+        console.log('  ✓ Technical docs up to date');
+      } else {
+        const isMinorOrMajor = level === 'minor' || level === 'major';
+        const prefix = isMinorOrMajor ? '✗' : '!';
+        console.log(`  ${prefix} Technical docs need attention:`);
+        for (const m of techDocsCheck.missing) console.log(`    - ${m}`);
+        if (isMinorOrMajor) {
+          console.log('');
+          console.log('  Update SKILL.md or TECHNICAL.md before a minor/major release.');
+          console.log('  Use --skip-tech-docs-check to override.');
+          console.log('');
+          return { currentVersion, newVersion, dryRun: false, failed: true };
+        }
+      }
+    }
+  }
+
+  // 0.9. Interface coverage check
+  if (!skipCoverageCheck) {
+    const coverageCheck = checkInterfaceCoverage(repoPath);
+    if (!coverageCheck.skipped) {
+      if (coverageCheck.ok) {
+        console.log('  ✓ Interface coverage table matches');
+      } else {
+        const isMinorOrMajor = level === 'minor' || level === 'major';
+        const prefix = isMinorOrMajor ? '✗' : '!';
+        console.log(`  ${prefix} Interface coverage table has mismatches:`);
+        for (const m of coverageCheck.missing) console.log(`    - ${m}`);
+        if (isMinorOrMajor) {
+          console.log('');
+          console.log('  Update the coverage table in README.md and SKILL.md.');
+          console.log('  Use --skip-coverage-check to override.');
+          console.log('');
+          return { currentVersion, newVersion, dryRun: false, failed: true };
+        }
+      }
+    }
+  }
+
   if (dryRun) {
     // Product docs check (dry-run)
     if (!skipProductCheck) {
@@ -999,6 +1231,32 @@ export async function release({ repoPath, level, notes, notesSource, dryRun, noP
         console.log('  [dry run] ✓ No stale remote branches');
       }
     }
+    // Technical docs check (dry-run)
+    if (!skipTechDocsCheck) {
+      const techDocsCheck = checkTechnicalDocs(repoPath);
+      if (!techDocsCheck.skipped) {
+        if (techDocsCheck.ok) {
+          console.log('  [dry run] ✓ Technical docs up to date');
+        } else {
+          const isMinorOrMajor = level === 'minor' || level === 'major';
+          console.log(`  [dry run] ${isMinorOrMajor ? '✗ Would BLOCK' : '! Would WARN'}: technical docs need updates`);
+          for (const m of techDocsCheck.missing) console.log(`    - ${m}`);
+        }
+      }
+    }
+    // Interface coverage check (dry-run)
+    if (!skipCoverageCheck) {
+      const coverageCheck = checkInterfaceCoverage(repoPath);
+      if (!coverageCheck.skipped) {
+        if (coverageCheck.ok) {
+          console.log('  [dry run] ✓ Interface coverage table matches');
+        } else {
+          const isMinorOrMajor = level === 'minor' || level === 'major';
+          console.log(`  [dry run] ${isMinorOrMajor ? '✗ Would BLOCK' : '! Would WARN'}: interface coverage mismatches`);
+          for (const m of coverageCheck.missing) console.log(`    - ${m}`);
+        }
+      }
+    }
     const hasSkill = existsSync(join(repoPath, 'SKILL.md'));
     console.log(`  [dry run] Would bump package.json to ${newVersion}`);
     if (hasSkill) console.log(`  [dry run] Would update SKILL.md version`);
@@ -1312,6 +1570,18 @@ export async function release({ repoPath, level, notes, notesSource, dryRun, noP
     console.log(`  ! Branch prune skipped: ${e.message}`);
   }
 
+  // Write release marker so branch guard blocks immediate install (#73)
+  try {
+    const markerDir = join(process.env.HOME || '', '.ldm', 'state');
+    const { mkdirSync, writeFileSync } = await import('node:fs');
+    mkdirSync(markerDir, { recursive: true });
+    writeFileSync(join(markerDir, '.last-release'), JSON.stringify({
+      repo: repoName,
+      version: newVersion,
+      timestamp: new Date().toISOString(),
+    }) + '\n');
+  } catch {}
+
   console.log('');
   console.log(`  Done. ${repoName} v${newVersion} released.`);
   console.log('');

package/tools/wip-release/mcp-server.mjs

@@ -31,6 +31,8 @@ server.setRequestHandler(ListToolsRequestSchema, async () => ({
           dryRun: { type: 'boolean', description: 'Preview only, no changes', default: false },
           noPublish: { type: 'boolean', description: 'Bump + tag only, skip npm/GitHub publish', default: false },
           skipProductCheck: { type: 'boolean', description: 'Skip product doc freshness check', default: false },
+          skipTechDocsCheck: { type: 'boolean', description: 'Skip technical docs freshness check', default: false },
+          skipCoverageCheck: { type: 'boolean', description: 'Skip interface coverage table check', default: false },
         },
         required: ['level', 'notes'],
       },
@@ -65,6 +67,8 @@ server.setRequestHandler(CallToolRequestSchema, async (req) => {
         notesSource: 'flag', // MCP always passes notes directly
         noPublish: args.noPublish || false,
         skipProductCheck: args.skipProductCheck || false,
+        skipTechDocsCheck: args.skipTechDocsCheck || false,
+        skipCoverageCheck: args.skipCoverageCheck || false,
       });
       return {
         content: [{

package/tools/wip-release/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wipcomputer/wip-release",
-  "version": "1.9.40",
+  "version": "1.9.41",
   "type": "module",
   "description": "One-command release pipeline. Bumps version, updates changelog + SKILL.md, publishes to npm + GitHub.",
   "main": "core.mjs",

package/tools/wip-repo-init/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wipcomputer/wip-repo-init",
-  "version": "1.9.40",
+  "version": "1.9.41",
   "description": "Scaffold the standard ai/ directory structure in any repo",
   "type": "module",
   "bin": {

package/tools/wip-repo-permissions-hook/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wipcomputer/wip-repo-permissions-hook",
-  "version": "1.9.40",
+  "version": "1.9.41",
   "type": "module",
   "description": "Repo visibility guard. Blocks repos from going public without a -private counterpart.",
   "main": "core.mjs",

package/tools/wip-repos/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wipcomputer/wip-repos",
-  "version": "1.9.40",
+  "version": "1.9.41",
   "type": "module",
   "description": "Repo manifest reconciler. Single source of truth for repo organization. Like prettier for folder structure.",
   "main": "core.mjs",

package/tools/wip-universal-installer/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wipcomputer/universal-installer",
-  "version": "1.9.40",
+  "version": "1.9.41",
   "type": "module",
   "description": "The Universal Interface specification for agent-native software. Teaches your AI how to build repos with every interface: CLI, Module, MCP Server, OpenClaw Plugin, Skill, Claude Code Hook.",
   "main": "detect.mjs",

package/tools/wip-repo-init/templates/product/plans-prds/todos/README 2.md

@@ -1,63 +0,0 @@
-# todos/
-
-One todo file per person or agent. Three sections per file: To Do, Done, Deprecated.
-
-## What This Folder Is
-
-Todos that are specific to this repo. Each person or agent who works on this repo gets one file. The file tracks what they need to do, what they've done, and what got dropped.
-
-For cross-repo work or bigger items, use GitHub Issues. Todos here are for repo-scoped tasks that don't need the overhead of an issue.
-
-## Files
-
-One file per person/agent. Name it `[Name]-todo.md`.
-
-Example:
-
-| File | Who |
-|------|-----|
-| `Parker-todo.md` | Parker (human tasks: reviews, credentials, approvals) |
-| `CC-Mini-todo.md` | Claude Code on Mac Mini (code, builds, deploys) |
-
-Create the file when that person/agent first has work to do. No empty placeholder files.
-
-## File Format
-
-```markdown
-# [Name] Todos
-
-**Last updated:** YYYY-MM-DD
-
-## To Do
-
-- [ ] Task description
-- [ ] Task description (blocked by: reason)
-
-## Done
-
-- [x] Task description (YYYY-MM-DD)
-- [x] Task description (YYYY-MM-DD)
-
-## Deprecated
-
-- ~~Task description~~ ... reason. (YYYY-MM-DD)
-```
-
-## Rules
-
-- **Never delete anything.** Items move between sections, never off the page.
-- **To Do** ... work that needs to happen.
-- **Done** ... completed work. Check the box, add the date.
-- **Deprecated** ... planned but no longer needed. Strikethrough, add the reason and date. Not the same as Done. Done means it shipped. Deprecated means the requirement changed.
-- **Update the date** at the top of the file every time you edit it.
-- **One file per person/agent.** No dated files, no subfolders, no inboxes.
-- **Blocked items** stay in To Do with a `(blocked by: reason)` note. Don't move them to a separate section.
-
-## When to Use Todos vs GitHub Issues
-
-| Use | When |
-|-----|------|
-| **Todo file** | Quick tasks, repo-scoped work, things you'll do this session or this week |
-| **GitHub Issue** | Bugs, feature requests, cross-repo work, things that need tracking or discussion |
-
-Both is fine. File an issue AND add a todo that references it. The todo is your personal checklist. The issue is the team's record.