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

[ottobot-ai]

🤖 Quality Score: 87/100

PR Agent Review — Tier 1 Gate

Category	Score	Notes
Description quality	21/25	Clear file structure, key decisions documented, 12 TDD test cases, source accuracy table
CI status	25/25	All checks green
Content quality	22/25	Comprehensive skill spec with templates, proto wire format verified
Commit compliance	12/15	Clean lowercase subject, within 72 chars
Hygiene	7/10	Good branch name, focused single-file change

Score 87/100 meets threshold (80+). Promoting to human review.

CC: @scasplte2 for final review.

[ottobot-ai]

⚠️ Merge conflict — manual resolution required

PR size: 1,665 lines (too large for automated conflict resolution)
Base branch: main

@scasplte2 — please rebase manually when ready.