Skip to content

AGENTS.md

Latest commit

 

History

History
31 lines (20 loc) · 1.88 KB

AGENTS.md

File metadata and controls

31 lines (20 loc) · 1.88 KB
Raw

agentic-creator-os — Agent Instructions

Read CLAUDE.md first (and GROK.md if present). They define ACOS v11+, Frank DNA, safety hooks, commands, skills, agent standards, and Grok Build (xAI) harness integration via grok-harness-adapter (see new .claude/skills/grok-harness/ + adapters/grok/). 5-fleet + SIP partition (grok-personal .grok-only seeds only).

Repo Role

agentic-creator-os is the reusable Agentic Creator OS substrate: commands, skills, workflow patterns, agent behavior standards, and safety primitives used by FrankX and sibling creative systems.

Work Pattern

  1. Read CLAUDE.md (and GROK.md/AGENTS.md for Grok) + any referenced .claude/ / .grok/ or skill docs before edits. Deeper wins.
  2. Preserve the Frank DNA and safety-first ACOS behavior. Apply repo-mastery + excellence (gstack/santa/verification) gates on Grok/ACOS changes. Read rules first (CLAUDE > AGENTS > GROK > deeper).
  3. Prefer improving existing commands/skills/hooks over inventing parallel surfaces. Extend adapters/grok/ + install.sh for Grok Build harness (keep seeds in sync between .ts and .sh). Add to .claude/skills/grok-harness/ for Claude-side awareness.
  4. Keep output practical and implementation-oriented; avoid abstract claims without examples. Show evidence (gstack screenshots, diffs, metrics).
  5. Do not touch unrelated dirty/untracked files. Scope with freeze/gstack-guard when needed.

Commands

npm run build:all
npm run install:all

The registry currently lists pnpm test, but package.json does not define a test script. If adding tests, add the script deliberately and document the runner.

Safety

  • Never weaken safety hooks, circuit breakers, audit trails, or self-modify gates without an explicit operator decision.
  • Treat ACOS as a shared substrate. Backward compatibility matters.
  • If changing public package behavior, update docs and versioning intentionally.