@champpaba/claude-agent-kit 2.1.4 → 2.1.6

package/.claude/CLAUDE.md

@@ -402,16 +402,21 @@ Prompt "Update PROJECT_STATUS.yml?" when detecting these patterns:
 
 | Event Detected | What to Update |
 |----------------|----------------|
-| After `/openspec:archive` completes | Add to `completed_changes` |
+| After `/openspec:archive` completes | Add to `completed_changes` + check Non-Goals for `pending_followups` |
 | User says "waiting for...", "need X from...", "blocked by..." | Add to `blockers` |
 | User mentions blocker resolved | Remove from `blockers` |
 | Infrastructure change (deploy, tunnel, DB migration) | Update `infrastructure` |
 | User discusses priority shift | Update `next_priorities` |
-| `/csetup {change-id}` started | Update `current_focus.active_change` |
+| `/csetup {change-id}` started | Update `current_focus` + **check `pending_followups` for related items** |
 | **Future features/ideas:** "อยากให้มี...", "want to add...", "later we should...", "in the future..." | Add to `future_ideas` |
 | **Technical debt:** "ต้องแก้...", "should refactor...", "tech debt...", "needs cleanup..." | Add to `technical_debt` |
 | **Decisions made:** "ตัดสินใจว่า...", "we decided...", "going with...", "chose X over Y" | Add to `decisions` |
 | **Learnings/notes:** "พบว่า...", "discovered...", "note:...", "important:..." | Add to `notes` |
+| **Problems found (by Claude):** "⚠️ ปัญหาที่พบ", "ไม่มี X", "missing X", "not configured" | Add to `technical_debt` or `blockers` |
+| **Config gaps:** "ไม่ได้ตั้งค่า...", "need to configure...", "should add to CI/CD" | Add to `technical_debt` |
+| **Sync issues:** "DB not synced", "schema mismatch", "local vs production differs" | Add to `blockers` + `infrastructure` |
+| **Non-Goal needs follow-up:** design.md has "Non-Goal: X (separate proposal)" | Add to `pending_followups` when archiving |
+| **Pending resolved:** User creates proposal for pending item | Remove from `pending_followups` |
 
 ### Update Protocol
 
@@ -453,6 +458,49 @@ User: "ตัดสินใจใช้ Drizzle แทน Prisma แล้ว
 Claude: "Add to PROJECT_STATUS.yml decisions?
          - decision: Use Drizzle over Prisma
          - reason: Better type safety"
+
+# Problem found by Claude during analysis
+Claude: "⚠️ ปัญหาที่พบ: ไม่มี migration step ใน CI/CD!"
+Claude: "Add to PROJECT_STATUS.yml?
+         technical_debt:
+         - item: Add DB migration to CI/CD
+         - reason: Schema not synced between local and VPS
+         - priority: high"
+
+# Config gap discovered
+Claude: "Local DB กับ VPS schema ไม่ sync กัน"
+Claude: "Add to PROJECT_STATUS.yml?
+         blockers:
+         - id: db-schema-sync
+         - description: Local and VPS DB schemas out of sync
+         infrastructure.database:
+         - status: degraded
+         - notes: Schema mismatch, need migration"
+
+# Archive with Non-Goals that need follow-up
+Claude: "Archiving add-infrastructure-cicd..."
+Claude: *reads design.md, finds Non-Goals: "Database migrations (separate proposal)"*
+Claude: "Add to PROJECT_STATUS.yml pending_followups?
+         - item: Database migration strategy
+         - from_change: add-infrastructure-cicd
+         - reason: Non-Goal marked 'separate proposal'
+         - affects: ['any change with DB schema']"
+
+# /csetup checks pending_followups (Medium aggressiveness)
+User: "/csetup add-auth-system"
+Claude: *reads PROJECT_STATUS.yml pending_followups*
+Claude: "⚠️ Found related pending follow-up:
+         - 'Database migration strategy' (from add-infrastructure-cicd)
+         - Affects: 'any change with DB schema'
+
+         This change adds DB tables. The migration strategy hasn't been addressed yet.
+
+         Options:
+         1. Continue anyway (risk: schema sync issues)
+         2. Address migration first (create proposal)
+         3. Add migration step to this change's scope
+
+         Which approach?"
 ```
 
 ---

package/.claude/commands/csetup.md

@@ -83,6 +83,50 @@ if (fileExists(projectStatusPath)) {
     }
   }
 
+  // Check pending follow-ups that might affect this change (v2.1.6)
+  if (projectStatus.pending_followups?.length > 0) {
+    const proposalPath = `openspec/changes/${changeId}/proposal.md`
+    const proposal = fileExists(proposalPath) ? Read(proposalPath).toLowerCase() : ''
+
+    const relatedPending = projectStatus.pending_followups.filter(p => {
+      const affects = p.affects || []
+      return affects.some(pattern => {
+        const patternLower = pattern.toLowerCase()
+        return changeId.toLowerCase().includes(patternLower) ||
+               proposal.includes(patternLower) ||
+               (patternLower.includes('db') && proposal.includes('table')) ||
+               (patternLower.includes('schema') && proposal.includes('model')) ||
+               (patternLower.includes('migration') && proposal.includes('database'))
+      })
+    })
+
+    if (relatedPending.length > 0) {
+      output(`\n   ⚠️ Found related pending follow-ups:`)
+      relatedPending.forEach(p => {
+        output(`      - "${p.item}" (from ${p.from_change})`)
+        output(`        Reason: ${p.reason}`)
+        if (p.affects) output(`        Affects: ${p.affects.join(', ')}`)
+      })
+
+      output(`\n   This change may be affected by unresolved follow-ups.`)
+      output(`   Options:`)
+      output(`      1. Continue anyway (risk: issues like schema sync)`)
+      output(`      2. Address follow-up first (create separate proposal)`)
+      output(`      3. Include follow-up in this change's scope`)
+
+      const choice = await askUser(`\n   How to proceed? (1/2/3)`)
+
+      if (choice === '2') {
+        output(`\n   ❌ Setup paused. Create proposal for pending follow-up first.`)
+        return
+      } else if (choice === '3') {
+        output(`\n   ℹ️ Remember to include follow-up items in tasks.md`)
+      } else {
+        output(`\n   ⚠️ Continuing with caution. Monitor for related issues.`)
+      }
+    }
+  }
+
   // Check stale status
   const lastUpdated = new Date(projectStatus.last_updated)
   const daysSinceUpdate = Math.floor((Date.now() - lastUpdated) / (1000 * 60 * 60 * 24))

package/.claude/templates/PROJECT_STATUS.template.yml

@@ -71,6 +71,26 @@ blockers: []
   #   description: "Waiting for Stripe test API key from finance team"
   #   blocks: [payment-integration]
 
+# -------------------------------------------------------------------
+# PENDING FOLLOW-UPS
+# Non-Goals from archived changes that need separate proposals
+# Captured when: archiving a change with Non-Goals marked "separate proposal"
+# Claude will warn during /csetup if new change relates to pending items
+# -------------------------------------------------------------------
+pending_followups: []
+  # Example:
+  # - item: "Database migration strategy"
+  #   from_change: "add-infrastructure-cicd"
+  #   reason: "Non-Goal: Database migrations (แยก proposal)"
+  #   affects: ["any change with DB schema changes"]
+  #   date: "2025-11-30"
+  #
+  # - item: "API rate limiting"
+  #   from_change: "add-auth-system"
+  #   reason: "Non-Goal: Rate limiting (phase 2)"
+  #   affects: ["public API endpoints"]
+  #   date: "2025-12-01"
+
 # -------------------------------------------------------------------
 # NEXT PRIORITIES
 # What should be worked on next (with reasoning)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@champpaba/claude-agent-kit",
-  "version": "2.1.4",
+  "version": "2.1.6",
   "description": "Universal multi-agent template for Claude Code - AI-assisted development with specialized agents",
   "main": "bin/cli.js",
   "bin": {