agent deck

AI Community

Skill notes

Script Path Resolution (IMPORTANT)

This skill includes helper scripts in its scripts/ subdirectory. When Claude Code loads this skill, it shows a line like: You MUST use that base directory path to resolve all script references. Store it as SKILL_DIR: Common mistake: Do NOT use <project-root>/scripts/launch-subagent.sh. The scripts live inside the skill's own directory (plugin cache or project skills folder), NOT in the user's project root.

Capabilities

What agent-deck does, at the noun level (independent of which surface — CLI / TUI / Web UI — you reach it through). Each row maps to one or more commands, keystrokes, or screens. For full surface coverage and per-row known issues, see your conductor's CAPABILITIES.md (generated by the Self-Improvement workflow below). Capability · What it does · Surfaces Manage sessions · Create, start, stop, restart, fork, send, output, remove a session · CLI ✅ · TUI ✅ · Web UI 🟡

Essential Commands

Command · Purpose agent-deck · Launch interactive TUI agent-deck add -t "Name" -c claude /path · Create session agent-deck session start/stop/restart <name> · Control session agent-deck session send <name> "message" · Send message

Sub-Agent Launch

Use when: User says "launch sub-agent", "create sub-agent", "spawn agent" The script auto-detects current session/profile and creates a child session.

Retrieval Modes

Mode · Command · Use When Fire & forget · (no --wait) · Default. Tell user: "Ask me to check when ready" On-demand · agent-deck session output "Title" · User asks to check Blocking · --wait flag · Need immediate result

Fluxly profile Runtime and permissions are inferred by Fluxly static checks, not author declarations or runtime test results.
Domain
AI
Author-declared agents
No explicit declaration found; this is not inferred or tested compatibility
Static check
88 / 100 · heuristic scan, not runtime safety proof
Runtime evidence
Not run; no isolated runtime test evidence is currently recorded
Author / version / license
@asheshgoplani · no license declared
Token usage
Heavy
Setup complexity
Manual integration
External API key
Required · Vendor-specific
Operating systems
macOS · Linux
Runtime requirements
Bun · Python
Detected file/system behavior
  • Read-only
  • Write / modify
  • Shell exec
  • Env read
Network behavior
External requests
Install commands
None (reference only)

Heads up: Tool permissions are not declared; actual access depends on the runtime.

Output preview agent-deck.preview
# Concrete examples from 2026-05-18 (the day this section was baked in)

1. **PR #885 over-claim.** A worker review reported "merge-ready; clean diff". Independent local re-test (`gh pr checkout 885 && go test -race ./...`) caught 2 failing tests. The reviewer had grepped the diff for obvious issues but never ran the suite. Lesson: code-review confidence ≠ test pass.
2. **ux-rethink-path verdict false-positive.** The ux-rethink-path worker reported "merge as-is; clean diff" for #885. User asked for a second look; a fresh peer verifier caught the same 2 failing tests the original worker missed. Lesson: reviewer + author in the same session-tree share priors. A peer session re-derives.
3. **Goal framework "metronome wakes".** The conductor's hourly wake cycles were firing `[STATUS]` replies with no actual work — the wake-loop had degenerated into a heartbeat instead of a do-work loop. User had to flag it manually. Lesson: a worker that hasn't run a ground-truth check since the last wake is not a working worker, it's a metronome. Bake the priority-0 check (below) into the wake template so this can't recur.

Discussion

Powered by GitHub Discussions. Sign in with GitHub to comment, react, or subscribe.