Human-Agent-Society/CORAL

CORAL Quickstart explains what CORAL does and when to use it, then walks through installing the CLI, registering a runtime, and scaffolding a `.coral_workspace/` for a codebase you want optimized. Use it to get from zero to a validated CORAL task and launch point.

Coral Debug verifies and debugs changes to CORAL itself, with the smallest repro loop for each area like grader, daemon, CLI, hooks, manager, workspace, hub, template, config, and web. Use it when editing code under coral/ or investigating a CORAL bug.

Coral Extend adds new components to the CORAL framework itself, such as agent runtimes, CLI commands, hooks, config fields, bundled templates, or grader infrastructure. Use it when changing the package internals, not for per-task graders or debugging existing code.

Coral New Task explains how to add a new CORAL task under examples/, including task.yaml, seed/, and a packaged grader. Use it when porting a benchmark or creating a task that CORAL can validate and grade.

Create Notes writes note files under notes/ that future agents can act on after evals, heartbeats, or infra issues. It covers note variants, required frontmatter, structured-trace fields, and linting helpers.

Creating A Coral Task explains how to scaffold a CORAL task with task.yaml, seed/, and a packaged grader/. It is used when authoring a new task, wiring a grader, porting a benchmark, or debugging scoring behavior.

Deep Research maps a problem before coding by searching for prior art, saving raw sources, and writing structured findings. Use it when starting a new task, changing approach, or working in an unfamiliar domain.

Organize Files restructures shared notes in research/ and experiments/, deduplicates related pages, and refreshes the index and links. Use it when the notes tree gets hard to navigate or has overlapping content.

Promoting Dev To Main handles CORAL release pull requests from dev into main and tells you how to merge them safely. Use it when reviewing conflicts, checking ancestry, or confirming release validation.

Running CORAL Experiments drives CORAL runs from the operator side with start, status, log/show, resume, heartbeat tuning, and stop. Use it to launch agents, monitor results, inspect attempts, steer a run, or diagnose failures.

Setting Up Coral configures local agent runtimes as named bindings for coral tasks. Use it to register Claude, Codex, Cursor, or other runtimes, then validate them with `coral agents doctor` when a run reports missing runtimes or auth errors.

Skill Creator detects repeated work patterns and turns them into reusable skills, then tests and iterates on the result. Use it when you notice recurring tool sequences, repeated code patterns, or want to benchmark an existing skill.