thoughtbox-team

$npx mdskill add Kastalien-Research/thoughtbox/thoughtbox-team

Spawns an agent team with a background analyst for Thoughtbox sessions.

  • Monitors reasoning sessions for contradictions and evolution candidates.
  • Depends on Thoughtbox and a configured analyst agent definition.
  • Activates when user requests session monitoring or starts deep reasoning.
  • Delivers periodic digests and background analysis without user orchestration.

SKILL.md

.github/skills/thoughtbox-teamView on GitHub ↗
---
name: thoughtbox-team
description: Spawn an Agent Team with a background Thoughtbox analyst teammate. The analyst monitors your reasoning sessions for evolution candidates, contradictions, and generates periodic digests. Use this at the start of any deep Thoughtbox reasoning session, when you're about to record many thoughts and want background analysis. Triggers on "start thoughtbox team", "I want a session analyst", "monitor my reasoning", or at the start of any session where you plan to use Thoughtbox extensively.
argument-hint: "[optional session ID to monitor]"
user-invocable: true
---

# Thoughtbox Team

Spawn a 2-agent team: you (lead) + a background analyst teammate that monitors your Thoughtbox session.

## When to Use

Use this when you're about to do significant Thoughtbox reasoning — sessions where you'll record 10+ thoughts and want background analysis of contradictions, evolution candidates, and session digests without having to orchestrate it yourself.

Don't use this for quick 1-3 thought sessions — the coordination overhead isn't worth it.

## How to Spawn

Tell Claude Code you want to create a team. The analyst teammate should be configured with:

- **Name**: `analyst`
- **Role**: Read the agent definition at `.claude/agents/thoughtbox-analyst.md` and use it as the teammate's instructions
- **Model**: Haiku (cost-efficient for background monitoring)
- **Focus**: Monitor the Thoughtbox session specified by $ARGUMENTS, or the most recent active session

Example spawn prompt:

```
Create an agent team with one teammate:
- Name: analyst
- Instructions: [contents of .claude/agents/thoughtbox-analyst.md]
- Task: Monitor Thoughtbox session [SESSION_ID] for evolution candidates and contradictions. Message me when you find thoughts that should be revised. Generate a digest every 20 thoughts.
```

## Working with the Analyst

Once the team is running:

1. **Do your work normally.** Record thoughts via `thoughtbox_execute` as usual.
2. **Watch for messages.** The analyst will message you when it finds evolution candidates.
3. **Respond to evolution signals.** When the analyst says "Thought 55 may contradict thoughts 5, 24", you decide whether to revise.
4. **Request digests.** Message the analyst: "Give me a digest of where we are."

## What the Analyst Does

- Periodically checks the session for new thoughts
- Runs deterministic evolution candidate detection (word overlap, structural heuristics)
- Flags `assumption_update` and `decision_frame` thoughts for special attention
- Generates compressed digests at milestones (~every 20 thoughts)
- Messages you with concise, actionable findings

## What the Analyst Does NOT Do

- Write code or modify files
- Apply revisions (it surfaces candidates, you decide)
- Interrupt for low-signal findings (only messages when overlap > 15%)
- Access anything outside Thoughtbox sessions

## Ending the Session

When your reasoning session is done, ask the analyst for a final digest, then dismiss the team. The digest can be used for session handoff or cross-session context injection.

More from Kastalien-Research/thoughtbox

SkillDescription
assumptionsManage the assumption registry — track, verify, and query assumptions about external dependencies and system behavior. Prevents costly rediscovery of known failures.
capture-learningCapture significant learnings from the current work session. Structures insights for future sessions and updates agent memory.
claude-opus-4-6-prompting>
claude-promptWrite or improve prompts for Claude using Anthropic's official best practices. Creates system prompts, agent prompts, tool descriptions, and MCP resource templates. Pass an existing prompt to improve it, or describe what you need to create one from scratch.
coolify-composeConvert Docker Compose files to Coolify templates. Use when creating Coolify services, converting docker-compose.yml for Coolify deployment, working with SERVICE_URL/SERVICE_PASSWORD magic variables, or troubleshooting Coolify compose errors.
crafting-effective-readmesUse when writing or improving README files. Not all READMEs are the same — provides templates and guidance matched to your audience and project type.
diagramGenerate architecture diagrams for a codebase subsystem or module. Explores source files and produces Mermaid diagrams in docs/.
diataxisStructure, classify, and write documentation using the Diátaxis framework. Use when writing docs, README files, guides, tutorials, how-to guides, API references, or organizing documentation architecture. Also use when asked to improve documentation, restructure docs, decide what type of doc to write, or classify existing content. Covers tutorials, how-to guides, reference, and explanation.
escalateFormat a structured escalation to the human decision-maker (Chief Agentic). Use when hitting an escalation threshold.
frontend-design-principlesCreate polished, intentional frontend interfaces. Use this skill when building any UI — dashboards, admin panels, landing pages, marketing sites, or web applications. Routes to specialized guidance based on context.