Skip to content

docs: COMMANDS.md reference + interactive HTML demo walkthrough#10

Merged
SamPlvs merged 1 commit into
mainfrom
claude/strange-swartz
Apr 9, 2026
Merged

docs: COMMANDS.md reference + interactive HTML demo walkthrough#10
SamPlvs merged 1 commit into
mainfrom
claude/strange-swartz

Conversation

@SamPlvs
Copy link
Copy Markdown
Owner

@SamPlvs SamPlvs commented Apr 9, 2026

Summary

  • docs/COMMANDS.md — comprehensive reference for all 23 slash commands. Each command includes: description, arguments, step-by-step behavior, and usage example. Linked from main README.
  • docs/demo.html — interactive visual walkthrough using the ZO brand system (amber/void, Share Tech Mono, Rajdhani, scanlines). 6 tabbed sections:
    • Overview: architecture diagram, key stats
    • User Workflow: 5 clickable steps with terminal mockups
    • Agent Teams: 10 agent cards with click-to-reveal details
    • ML Pipeline: 6 phases with mode toggle (classical/DL/research)
    • Commands: searchable command palette
    • MNIST Demo: before/after, metrics, timeline
  • README.md — added Commands section with summary table linking to full reference
  • Session state — STATE.md, DECISION_LOG updated for session end

🤖 Generated with Claude Code

- docs/COMMANDS.md: comprehensive reference for all 23 slash commands
  organized by category with descriptions, arguments, step-by-step
  behavior, and usage examples

- docs/demo.html: interactive visual walkthrough using ZO brand system
  (amber/void, Share Tech Mono, Rajdhani, scanlines). 6 tabbed sections:
  Overview, User Workflow, Agent Teams, ML Pipeline, Commands, MNIST Demo.
  Clickable steps, expandable cards, mode toggle, search palette.

- README.md: added Commands section with summary table linking to
  docs/COMMANDS.md

- STATE.md: marked project complete, documented known issues and next steps

- DECISION_LOG: recorded slash commands decision (RD13)

Session end — ZO v1.0 complete and validated. Ready for IVL F5.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@SamPlvs SamPlvs merged commit dda4433 into main Apr 9, 2026
@SamPlvs SamPlvs deleted the claude/strange-swartz branch April 9, 2026 21:38
SamPlvs added a commit that referenced this pull request Apr 25, 2026
Capture the design idea surfaced by the session-022 spawn-crash diagnosis:
add a --low-resources flag (or plan-level ## Resources block) that tells the
Lead Orchestrator to spawn agents serially within a phase instead of in
parallel. Eliminates the burst spike that trips kern.maxprocperuid=2666 on
marginal-resource Macs (specifically classical_ml Phase 1 spawning 5 agents).

PR-015 deliberately set 5-agent Phase 1 as the production default; a
flag-gated alternative preserves that while giving resource-constrained
users an escape hatch.

Logged in STATE.md What's Next #10 + DECISION_LOG ROADMAP entry with
implementation touch points (orchestrator.py _prompt_coordination(), cli.py
flag plumbing, optional plan parser support). Cross-refs PR-015, PR #52
troubleshooting doc, session-022 diagnosis.

Picking up next session.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
SamPlvs added a commit that referenced this pull request Apr 30, 2026
Capture the design idea surfaced by the session-022 spawn-crash diagnosis:
add a --low-resources flag (or plan-level ## Resources block) that tells the
Lead Orchestrator to spawn agents serially within a phase instead of in
parallel. Eliminates the burst spike that trips kern.maxprocperuid=2666 on
marginal-resource Macs (specifically classical_ml Phase 1 spawning 5 agents).

PR-015 deliberately set 5-agent Phase 1 as the production default; a
flag-gated alternative preserves that while giving resource-constrained
users an escape hatch.

Logged in STATE.md What's Next #10 + DECISION_LOG ROADMAP entry with
implementation touch points (orchestrator.py _prompt_coordination(), cli.py
flag plumbing, optional plan parser support). Cross-refs PR-015, PR #52
troubleshooting doc, session-022 diagnosis.

Picking up next session.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
SamPlvs added a commit that referenced this pull request Apr 30, 2026
docs: COMMANDS.md reference + interactive HTML demo walkthrough
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant