Skip to content

AGENTS.md

Latest commit

 

History

History
39 lines (27 loc) · 1.4 KB

AGENTS.md

File metadata and controls

39 lines (27 loc) · 1.4 KB
Raw

AGENTS.md — loop-engineering reference

Conventions for humans and loops maintaining this repository.

Build & verify

# Loop readiness audit CLI
cd tools/loop-audit && npm ci && npm run build
node dist/cli.js ../..              # audit repo root
node dist/cli.js ../.. --suggest    # show copy commands for gaps

# Before/after demo (scores an empty dir → starter → L2)
bash scripts/before-after-demo.sh

CI runs validate-patterns and audit on every push/PR (see .github/workflows/).

Review norms

  • Patterns and starters must stay tool-agnostic in intent; tool-specific paths live under examples/ and per-tool starters.
  • Never auto-merge changes to docs/primitives*.md, tools/loop-audit/src/, or showcase assets without human review.
  • Failure stories in stories/ should include token cost, root cause, and remediation — not just wins.
  • New patterns require an entry in patterns/registry.yaml.

Loop operation (this repo)

  • Daily triage: loop-triage skill → STATE.md (report-only, L1).
  • Fixes: only via PR with human review; minimal-fix + loop-verifier for assisted changes (L2).
  • Isolation: use git worktrees for any unattended code-change experiments (see LOOP.md).

Test commands

This repo has no application test suite. Quality gates:

cd tools/loop-audit && npm run build && node dist/cli.js ../../
bash scripts/before-after-demo.sh