Skip to content

ethanplusai/codex-on-crack / plugins/codex-on-crack/skills/crack

Lead substantial Codex builds with one configured implementation worker and lead acceptance. Use when the user requests codex-on-crack, names a model to delegate work to, asks to run subagents through Claude, or requests a lead/worker split. Keep host-only work direct; honor explicit external model choices. Workers must not invoke this orchestrator.

FileKindSize
SKILL.mdskill md8.0 KB
agents/openai.yamlconfig300 B
references/build-records.mdmarkdown2.7 KB
references/checkpoint.mdmarkdown1.3 KB
references/external-lead.mdmarkdown13.9 KB
references/measurement.mdmarkdown1.8 KB
references/model-selection.mdmarkdown2.2 KB
references/parallel.mdmarkdown1.7 KB
references/policy.mdmarkdown494 B
references/replay.mdmarkdown3.2 KB
references/verification.mdmarkdown2.1 KB
references/worker-contract.mdmarkdown1.3 KB
scripts/doctor.mjsscript608 B
scripts/lead.mjsscript26.0 KB
scripts/lib/catalog.mjsscript5.6 KB
scripts/lib/changes.mjsscript13.3 KB
scripts/lib/config.mjsscript6.5 KB
scripts/lib/external-lead.mjsscript56.7 KB
scripts/lib/io.mjsscript3.8 KB
scripts/lib/lead-protocol.mjsscript25.9 KB
scripts/lib/plan.mjsscript9.2 KB
scripts/lib/readiness.mjsscript6.0 KB
scripts/lib/report.mjsscript10.7 KB
scripts/lib/roles.mjsscript8.9 KB
scripts/lib/routing.mjsscript2.7 KB
scripts/lib/toml.mjsscript785 B
scripts/lib/trial.mjsscript12.4 KB
scripts/report.mjsscript2.7 KB
scripts/select.mjsscript3.9 KB
scripts/setup.mjsscript7.0 KB
scripts/trial.mjsscript1.8 KB
scripts/validate-plan.mjsscript2.6 KB
scripts/worktree.mjsscript7.8 KB
templates/checkpoint.mdmarkdown903 B
templates/plan.jsonconfig680 B
templates/spec.mdmarkdown742 B
templates/task-brief.mdmarkdown2.5 KB
templates/task-report.mdmarkdown1.5 KB
viewer/README.mdmarkdown5.9 KB
viewer/bridge.mjsscript16.6 KB
viewer/fixtures/sample.jsonconfig8.2 KB
viewer/package.jsonmanifest187 B
viewer/public/app.mjsscript8.8 KB
viewer/public/index.htmlother1.8 KB
viewer/public/style.cssother4.4 KB
viewer/serve.mjsscript11.2 KB
viewer/src/adapter.mjsscript9.9 KB
viewer/src/emit.mjsscript992 B
viewer/src/model.mjsscript8.9 KB
viewer/src/server.mjsscript4.1 KB
viewer/src/tail.mjsscript1.9 KB
viewer/test/browser.mjsscript2.6 KB
viewer/test/server.test.mjsscript3.2 KB
viewer/test/usage.test.mjsscript9.0 KB
viewer/test/viewer.test.mjsscript5.1 KB

scripts/validate-plan.mjs

View on GitHub
#!/usr/bin/env node
// Lint a plan (schema 2) and compute its waves. Runs no commands; approves nothing.
import path from 'node:path';
import { parseArgs } from 'node:util';
import { CrackError, ok, readInput, run } from './lib/io.mjs';
import { locations } from './lib/config.mjs';
import { managedPaths } from './lib/changes.mjs';
import { parseCrackToml } from './lib/roles.mjs';
import { rolesForPlan, validatePlan } from './lib/plan.mjs';

const OPTIONS = {
  'repo-root': { type: 'string' },
  'crack-toml': { type: 'string' },
  home: { type: 'string' },
  'codex-home': { type: 'string' },
};
const USAGE = 'Usage: validate-plan.mjs <plan.json> [--repo-root dir] [--crack-toml path] [--home dir] [--codex-home dir]';

run((argv) => {
  let parsed;
  try {
    parsed = parseArgs({ args: argv, options: OPTIONS, allowPositionals: true, strict: true });
  } catch (error) {
    throw new CrackError('usage', error.message, USAGE);
  }
  const { positionals, values } = parsed;
  if (positionals.length !== 1) throw new CrackError('usage', 'Pass exactly one plan.json.', USAGE);
  const planPath = path.resolve(positionals[0]);
  const planData = readInput(planPath);
  if (planData === null) throw new CrackError('plan_missing', `No plan at ${planPath}.`, 'Pass the path to plan.json.');
  let plan;
  try {
    plan = JSON.parse(planData.toString('utf8'));
  } catch {
    throw new CrackError('plan_invalid', 'plan.json is not valid JSON.', 'Fix the JSON syntax, then validate again.');
  }
  const explicit = values['crack-toml'] !== undefined;
  const crackPath = explicit
    ? path.resolve(values['crack-toml'])
    : managedPaths(locations({ home: values.home, codexHome: values['codex-home'] }).codexHome).crackToml;
  const crackData = readInput(crackPath);
  let roles = new Map();
  if (crackData === null) {
    // Direct work needs no roles, so a plan made only of orchestrator tasks is
    // valid with no crack.toml at the default location. An explicit --crack-toml
    // names a file, so a missing one is a real error rather than an empty default.
    if (explicit) {
      throw new CrackError('roles_missing', `No crack.toml at ${crackPath}.`,
        'Pass an existing config, keep the plan orchestrator-only for direct work, or run $codex-on-crack:crack-setup.');
    }
  } else {
    // Fail closed on a malformed or role-less configuration instead of quietly
    // treating it as "no roles configured".
    roles = rolesForPlan(parseCrackToml(crackData.toString('utf8')));
  }
  const root = path.resolve(values['repo-root'] ?? path.dirname(planPath));
  return ok(validatePlan(plan, root, roles));
});
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 470kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 322kUpdated Claude CodeCodexVerifiedInstall