Titan Poll

# /titan-poll - In-Session Inbox Polling

**Purpose**: Allow Titans to poll their inbox for new commands from within a Claude Code session
**Usage**: `/titan-poll [TITAN_NAME]`

---

## Protocol

When invoked, this command:

1. Reads the specified Titan's `inbox.md` file
2. Scans for `[NEW]` command markers
3. If found, displays the command and prompts for execution
4. If not found, reports "No new commands" and suggests standby or retry

---

## Implementation

TITAN POLL PROTOCOL ═══════════════════

Step 1: Read inbox file Path: .claude/coordination/session-26-persistent/[TITAN]/inbox.md

Step 2: Scan for patterns

• [NEW] → New command detected

• [IN_PROGRESS] → Command being executed

• [COMPLETE] → Command finished

Step 3: If [NEW] found: a. Display command details b. Ask: "Execute this command? [Y/n]" c. If yes: - Change [NEW] → [IN_PROGRESS] in inbox.md - Execute the command - Write result to outbox.md - Change [IN_PROGRESS] → [COMPLETE] in inbox.md - Update status.md

Step 4: If no [NEW] found:

• Display: "No new commands for [TITAN]"
• Suggest: Poll again in 10 seconds or enter standby

Step 5: Return to polling loop

---

## Example Execution

**User**: `/titan-poll FORGE`

**Agent Response**:

📬 POLLING INBOX: FORGE

Scanning .claude/coordination/session-26-persistent/FORGE/inbox.md...

⚡ NEW COMMAND DETECTED! ━━━━━━━━━━━━━━━━━━━━━━━━ Priority: HIGH From: ZEUS Command: Implement the new API endpoint for contractor search Expected: Working /api/contractors/search endpoint

Execute this command? [Y/n]

---

## Continuous Polling Mode

To enter persistent polling:

/titan-poll FORGE --loop

This will:

1. Poll every 10 seconds
2. Auto-execute commands
3. Continue until STOP signal or timeout (5 min)

---

## Integration with Sacred Loop

This skill implements the READ phase of the Sacred Loop:

READ → /titan-poll [TITAN] (This skill) SCAN → Automatic (finds [NEW] markers) CLAIM → Automatic (changes to [IN_PROGRESS]) WORK → Agent executes the command WRITE → Agent updates outbox.md + status.md REPEAT → Poll again

---

## Files Affected

| File | Action |
|------|--------|
| `[TITAN]/inbox.md` | Read, mark [IN_PROGRESS], mark [COMPLETE] |
| `[TITAN]/outbox.md` | Write completion report |
| `[TITAN]/status.md` | Update current task |

---

**THE LOOP CONTINUES. POLL → EXECUTE → REPORT → REPEAT.**