Files

Paul O'Reilly e7c8214499 Add statusline scripts, context-load improvements, and prior distill updates

- Add statusline.sh and set-topic.sh for per-session status line topics
- Update context-load with improved directory walking and output format
- Update CLAUDE.md with status line docs and early-call safety note
- Update MEMORY.md and README.md with new script/skill entries
- Add memory files: script-statusline, skill-decompose, skill-orchestrate, gotchas-gitea
- Add networking.md best practice (nftables, systemd sockets, Docker forwarding, TLS)
- Update best practices from prior distill: documentation, kubernetes, scripting,
  secrets-management, skills-development
- Prune reflected session logs, add new session logs
- Update reflection state

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

2026-03-25 11:11:40 +13:00

1.9 KiB

Raw Blame History

name, description, type

name	description	type
skill-decompose	/decompose skill — breaks tasks into subtasks with dependency graph, writes .agent-tasks.json for container agent orchestration	reference

/decompose Skill

Purpose

Decompose a complex task into independently-executable subtasks with a dependency graph. Each subtask gets a full prompt for a container agent. Writes .agent-tasks.json in the project root for /orchestrate to consume.

Usage

/decompose <task description>
/decompose                     # uses conversation context

How It Works

Reads project context (CLAUDE.md, SPEC.md, PLAN.md, spec/) to understand the project
Breaks the task into subtasks — each self-contained, scoped to one deliverable, testable
Presents a dependency graph and table for user approval
Asks user to set max_concurrent (number of simultaneous container agents)
Writes .agent-tasks.json with task IDs, prompts, dependencies, reads/writes, and status fields

Task State Format

{
  "created_at": "ISO timestamp",
  "project": "project-name",
  "max_concurrent": 3,
  "tasks": {
    "task-id": {
      "name": "...", "prompt": "...", "depends_on": [],
      "reads": [], "writes": [],
      "status": "pending", "branch": null, "worktree": null,
      "host": null, "container_id": null,
      "started_at": null, "completed_at": null,
      "exit_code": null, "error": null
    }
  }
}

Status values: pending, running, completed, failed, blocked.

Gotchas

Task prompts need to be fully self-contained — container agents have no conversation history
Include explicit "read these files first" instructions in each task's prompt
Over-decomposing creates merge overhead; under-decomposing wastes parallelism potential

Used By

agent-runtimes — M3 harness implementation decomposition
Any project needing parallel container agent work

1.9 KiB Raw Blame History