docs: ottochain-new-app OpenClaw skill specification

[ottobot-ai]

Summary

Specification for the ottochain-new-app OpenClaw AgentSkill — packaging the Adding a New App guide (PR #86) into a reusable skill that any agent can invoke.

Trello: [skill] Create 'ottochain-new-app' skill (6987a9d1)

What This Spec Defines

Skill File Structure

/home/euler/.openclaw/skills/ottochain-new-app/
├── SKILL.md                          # Trigger phrases + step-by-step procedure  
└── templates/
    ├── state-machine.json            # SM definition (proto wire format, verified)
    ├── bridge-route.ts               # Express routes with Zod + submitTransaction
    ├── fiber-definition.ts           # Traffic gen FiberDefinition
    ├── explorer-component.tsx        # Indexer REST UI stub
    └── checklist.md                  # 6-step deployment checklist

Key Decisions

• Proto wire format: State IDs as { "id": { "value": "STATE" } } — verified against ottochain-sdk/src/apps/contracts/
• waitForSequence: Mandatory after every state-changing transition — race condition documented
• $epochProgress not $timestamp** for deadline guards — documented in Common Mistakes
• Indexer REST (not gateway GraphQL) for basic explorer listing — no new gateway dependencies
• Schema field in initialData — required for indexer filtering

12 TDD Test Cases

Tests verify all template patterns match real code. @code writes failing tests first, then implements skill.

Source Accuracy Table

Every pattern traced back to a specific file in /home/euler/repos/.

Next Step

→ 🧪 Test Definition: @code writes 12 failing tests, then implements skill files