@tekyzinc/gsd-t 2.28.13 → 2.28.14

package/commands/gsd-t-brainstorm.md

@@ -85,22 +85,35 @@ If mode is unclear, ask: "What kind of thinking would be most useful right now
 5. Periodically collect the best ideas into a running list
 
 ### Team Mode (if enabled and user requests):
+
+**OBSERVABILITY LOGGING (MANDATORY):**
+Before spawning the team — run via Bash:
+`T_START=$(date +%s) && DT_START=$(date +"%Y-%m-%d %H:%M") && TOK_START=${CLAUDE_CONTEXT_TOKENS_USED:-0} && TOK_MAX=${CLAUDE_CONTEXT_TOKENS_MAX:-200000}`
+
 ```
 Create an agent team for brainstorming:
 
-- Teammate "visionary": Push boundaries. What's the most ambitious 
-  version? What would make this remarkable? Think in terms of 
+- Teammate "visionary": Push boundaries. What's the most ambitious
+  version? What would make this remarkable? Think in terms of
   possibilities, not constraints.
 
 - Teammate "pragmatist": Keep it real. What can we actually build?
   What's the shortest path to value? Where are the hidden costs?
 
-- Teammate "devil's advocate": Challenge everything. Why might this 
+- Teammate "devil's advocate": Challenge everything. Why might this
   fail? What are we not seeing? Which assumptions are weakest?
 
 Lead: Synthesize the best insights from all three perspectives.
 ```
 
+After team completes — run via Bash:
+`T_END=$(date +%s) && DT_END=$(date +"%Y-%m-%d %H:%M") && TOK_END=${CLAUDE_CONTEXT_TOKENS_USED:-0} && DURATION=$((T_END-T_START))`
+Compute tokens and compaction:
+- No compaction (TOK_END >= TOK_START): `TOKENS=$((TOK_END-TOK_START))`, COMPACTED=null
+- Compaction detected (TOK_END < TOK_START): `TOKENS=$(((TOK_MAX-TOK_START)+TOK_END))`, COMPACTED=$DT_END
+Append to `.gsd-t/token-log.md` (create with header `| Datetime-start | Datetime-end | Command | Step | Model | Duration(s) | Notes | Tokens | Compacted |` if missing):
+`| {DT_START} | {DT_END} | gsd-t-brainstorm | Step 3 | sonnet | {DURATION}s | team brainstorm: {topic summary} | {TOKENS} | {COMPACTED} |`
+
 ## Step 4: Capture the Sparks
 
 As ideas emerge, maintain a running list. Don't over-organize — just capture:

package/commands/gsd-t-debug.md

@@ -7,6 +7,11 @@ You are debugging an issue in a contract-driven project. Your approach should id
 To give this debug session a fresh context window and prevent compaction, always execute via a Task subagent.
 
 **If you are the orchestrating agent** (you received the slash command directly):
+
+**OBSERVABILITY LOGGING (MANDATORY):**
+Before spawning — run via Bash:
+`T_START=$(date +%s) && DT_START=$(date +"%Y-%m-%d %H:%M") && TOK_START=${CLAUDE_CONTEXT_TOKENS_USED:-0} && TOK_MAX=${CLAUDE_CONTEXT_TOKENS_MAX:-200000}`
+
 Spawn a fresh subagent using the Task tool:
 ```
 subagent_type: general-purpose
@@ -14,7 +19,16 @@ prompt: "You are running gsd-t-debug for this issue: {$ARGUMENTS}
 Working directory: {current project root}
 Read CLAUDE.md and .gsd-t/progress.md for project context, then execute gsd-t-debug starting at Step 1."
 ```
-Wait for the subagent to complete. Relay its summary to the user. **Do not execute Steps 1–5 yourself.**
+
+After subagent returns — run via Bash:
+`T_END=$(date +%s) && DT_END=$(date +"%Y-%m-%d %H:%M") && TOK_END=${CLAUDE_CONTEXT_TOKENS_USED:-0} && DURATION=$((T_END-T_START))`
+Compute tokens and compaction:
+- No compaction (TOK_END >= TOK_START): `TOKENS=$((TOK_END-TOK_START))`, COMPACTED=null
+- Compaction detected (TOK_END < TOK_START): `TOKENS=$(((TOK_MAX-TOK_START)+TOK_END))`, COMPACTED=$DT_END
+Append to `.gsd-t/token-log.md` (create with header `| Datetime-start | Datetime-end | Command | Step | Model | Duration(s) | Notes | Tokens | Compacted |` if missing):
+`| {DT_START} | {DT_END} | gsd-t-debug | Step 0 | sonnet | {DURATION}s | debug: {issue summary} | {TOKENS} | {COMPACTED} |`
+
+Relay the subagent's summary to the user. **Do not execute Steps 1–5 yourself.**
 
 **If you are the spawned subagent** (your prompt says "starting at Step 1"):
 Continue to Step 1 below.

package/commands/gsd-t-discuss.md

@@ -51,6 +51,10 @@ Work through each open question systematically:
 ### Team Mode (when agent teams are enabled):
 If the user requests team exploration or there are 3+ complex open questions:
 
+**OBSERVABILITY LOGGING (MANDATORY):**
+Before spawning the team — run via Bash:
+`T_START=$(date +%s) && DT_START=$(date +"%Y-%m-%d %H:%M") && TOK_START=${CLAUDE_CONTEXT_TOKENS_USED:-0} && TOK_MAX=${CLAUDE_CONTEXT_TOKENS_MAX:-200000}`
+
 ```
 Create an agent team:
 
@@ -61,12 +65,20 @@ ALL TEAMMATES read first:
 
 Assign each teammate a distinct perspective:
 - Teammate 1: Advocate for approach A — build strongest case
-- Teammate 2: Advocate for approach B — build strongest case  
+- Teammate 2: Advocate for approach B — build strongest case
 - Teammate 3: Critic — find weaknesses in both, identify risks
 
 Lead: Synthesize into decisions and update contracts.
 ```
 
+After team completes — run via Bash:
+`T_END=$(date +%s) && DT_END=$(date +"%Y-%m-%d %H:%M") && TOK_END=${CLAUDE_CONTEXT_TOKENS_USED:-0} && DURATION=$((T_END-T_START))`
+Compute tokens and compaction:
+- No compaction (TOK_END >= TOK_START): `TOKENS=$((TOK_END-TOK_START))`, COMPACTED=null
+- Compaction detected (TOK_END < TOK_START): `TOKENS=$(((TOK_MAX-TOK_START)+TOK_END))`, COMPACTED=$DT_END
+Append to `.gsd-t/token-log.md` (create with header `| Datetime-start | Datetime-end | Command | Step | Model | Duration(s) | Notes | Tokens | Compacted |` if missing):
+`| {DT_START} | {DT_END} | gsd-t-discuss | Step 3 | sonnet | {DURATION}s | team discuss: {topic summary} | {TOKENS} | {COMPACTED} |`
+
 Assign teammates based on the nature of the questions:
 - **Technical choice** (e.g., which database): one advocate per option + critic
 - **Architecture pattern** (e.g., monolith vs microservice): one advocate per pattern + someone evaluating migration path

package/commands/gsd-t-quick.md

@@ -7,6 +7,11 @@ You are executing a small, focused task that doesn't need full phase planning. T
 To give this task a fresh context window and prevent compaction during consecutive quick runs, always execute via a Task subagent.
 
 **If you are the orchestrating agent** (you received the slash command directly):
+
+**OBSERVABILITY LOGGING (MANDATORY):**
+Before spawning — run via Bash:
+`T_START=$(date +%s) && DT_START=$(date +"%Y-%m-%d %H:%M") && TOK_START=${CLAUDE_CONTEXT_TOKENS_USED:-0} && TOK_MAX=${CLAUDE_CONTEXT_TOKENS_MAX:-200000}`
+
 Spawn a fresh subagent using the Task tool:
 ```
 subagent_type: general-purpose
@@ -14,7 +19,16 @@ prompt: "You are running gsd-t-quick for this request: {$ARGUMENTS}
 Working directory: {current project root}
 Read CLAUDE.md and .gsd-t/progress.md for project context, then execute gsd-t-quick starting at Step 1."
 ```
-Wait for the subagent to complete. Relay its summary to the user. **Do not execute Steps 1–5 yourself.**
+
+After subagent returns — run via Bash:
+`T_END=$(date +%s) && DT_END=$(date +"%Y-%m-%d %H:%M") && TOK_END=${CLAUDE_CONTEXT_TOKENS_USED:-0} && DURATION=$((T_END-T_START))`
+Compute tokens and compaction:
+- No compaction (TOK_END >= TOK_START): `TOKENS=$((TOK_END-TOK_START))`, COMPACTED=null
+- Compaction detected (TOK_END < TOK_START): `TOKENS=$(((TOK_MAX-TOK_START)+TOK_END))`, COMPACTED=$DT_END
+Append to `.gsd-t/token-log.md` (create with header `| Datetime-start | Datetime-end | Command | Step | Model | Duration(s) | Notes | Tokens | Compacted |` if missing):
+`| {DT_START} | {DT_END} | gsd-t-quick | Step 0 | sonnet | {DURATION}s | quick: {task summary} | {TOKENS} | {COMPACTED} |`
+
+Relay the subagent's summary to the user. **Do not execute Steps 1–5 yourself.**
 
 **If you are the spawned subagent** (your prompt says "starting at Step 1"):
 Continue to Step 1 below.

package/commands/gsd-t-verify.md

@@ -106,7 +106,19 @@ Teammate assignments:
   - Secret/credential handling
   Report: severity-ranked findings.
 
-Lead: After receiving teammate reports, spawn a Task subagent to run the full test suite and contract audit. Collect all reports, synthesize, create remediation plan.
+Lead: After receiving teammate reports:
+**OBSERVABILITY LOGGING (MANDATORY):**
+Before spawning — run via Bash:
+`T_START=$(date +%s) && DT_START=$(date +"%Y-%m-%d %H:%M") && TOK_START=${CLAUDE_CONTEXT_TOKENS_USED:-0} && TOK_MAX=${CLAUDE_CONTEXT_TOKENS_MAX:-200000}`
+Spawn a Task subagent to run the full test suite and contract audit.
+After subagent returns — run via Bash:
+`T_END=$(date +%s) && DT_END=$(date +"%Y-%m-%d %H:%M") && TOK_END=${CLAUDE_CONTEXT_TOKENS_USED:-0} && DURATION=$((T_END-T_START))`
+Compute tokens and compaction:
+- No compaction (TOK_END >= TOK_START): `TOKENS=$((TOK_END-TOK_START))`, COMPACTED=null
+- Compaction detected (TOK_END < TOK_START): `TOKENS=$(((TOK_MAX-TOK_START)+TOK_END))`, COMPACTED=$DT_END
+Append to `.gsd-t/token-log.md` (create with header `| Datetime-start | Datetime-end | Command | Step | Model | Duration(s) | Notes | Tokens | Compacted |` if missing):
+`| {DT_START} | {DT_END} | gsd-t-verify | Step 4 | haiku | {DURATION}s | test audit + contract review | {TOKENS} | {COMPACTED} |`
+Collect all reports, synthesize, create remediation plan.
 ```
 
 ## Step 5: Compile Verification Report

package/commands/gsd-t-wave.md

@@ -47,6 +47,10 @@ For each remaining phase, spawn an **independent agent** using the Task tool. Ea
 
 For each phase, spawn the agent like this:
 
+**OBSERVABILITY LOGGING (MANDATORY) — repeat for every phase spawn:**
+Before spawning — run via Bash:
+`T_START=$(date +%s) && DT_START=$(date +"%Y-%m-%d %H:%M") && TOK_START=${CLAUDE_CONTEXT_TOKENS_USED:-0} && TOK_MAX=${CLAUDE_CONTEXT_TOKENS_MAX:-200000}`
+
 ```
 Task agent (subagent_type: "general-purpose", mode: "bypassPermissions"):
   "Execute the {PHASE} phase of the current GSD-T milestone.
@@ -65,6 +69,14 @@ Task agent (subagent_type: "general-purpose", mode: "bypassPermissions"):
    Report back: one-line status summary."
 ```
 
+After phase agent returns — run via Bash:
+`T_END=$(date +%s) && DT_END=$(date +"%Y-%m-%d %H:%M") && TOK_END=${CLAUDE_CONTEXT_TOKENS_USED:-0} && DURATION=$((T_END-T_START))`
+Compute tokens and compaction:
+- No compaction (TOK_END >= TOK_START): `TOKENS=$((TOK_END-TOK_START))`, COMPACTED=null
+- Compaction detected (TOK_END < TOK_START): `TOKENS=$(((TOK_MAX-TOK_START)+TOK_END))`, COMPACTED=$DT_END
+Append to `.gsd-t/token-log.md` (create with header `| Datetime-start | Datetime-end | Command | Step | Model | Duration(s) | Notes | Tokens | Compacted |` if missing):
+`| {DT_START} | {DT_END} | gsd-t-wave | {PHASE} | sonnet | {DURATION}s | phase: {PHASE} | {TOKENS} | {COMPACTED} |`
+
 ### Phase Sequence
 
 Execute phases in this order, spawning one agent per phase:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tekyzinc/gsd-t",
-  "version": "2.28.13",
+  "version": "2.28.14",
   "description": "GSD-T: Contract-Driven Development for Claude Code — 45 slash commands with backlog management, impact analysis, test sync, and milestone archival",
   "author": "Tekyz, Inc.",
   "license": "MIT",