Before you build

Set the boundaries before your AI builds.

Describe your project. Decide who can do what, which limits apply, and what happens when something fails. Get a clear brief to give your coding agent.

Already have a working project? Review it and plan the next improvements.

Try an example

Start with one click.

Each example starts a browser-local review. Nothing is compiled until you choose to create the files.

Keep it high-level. Do not paste secrets, customer records, credentials, or source code. We check the local library first, then show you what matched.

Optional settingsContext about you, and a Cloudflare AI fallback

About you (optional)

Choose the setting closest to your work. It does not affect the review and is counted only as a group.

No account or repository access. Matching runs in your browser. Creating the files sends your description and answers to our Cloudflare-hosted compiler; they are not stored. The Cloudflare AI check is separate and optional. Do not include secrets or private data.

A clearer hand-off

Three useful things to settle first.
  1. See what matters

    Find the parts of your idea that affect how it should be built.

  2. Make the important calls

    Set limits, approvals, and scope—or leave them open for later.

  3. Hand over a useful brief

    Give your agent requirements and a way to report evidence, with recipes and validation scenarios where available.

What you get

Ready for your agent
  • Build instructions.agentdirective/agent-directive.jsonStructured rules your coding agent can follow.
  • Readable project brief.agentdirective/AGENTDIRECTIVE.mdA plain-language version for people and agents.
  • Implementation progress.agentdirective/control-status.jsonWhat your agent reports as built, incomplete, or still open.
Clear instructions, not a vague score.

Your agent gets the boundaries to implement, available validation scenarios, and a structured way to report progress.

How it works

From an idea to a clear hand-off.

Six steps, in order. Scroll to move through them.

  1. 01 / Describe

    Tell us what you want to build.

    No account, repository, or source code. Just the description you were going to give your coding agent.

    What are you asking your AI to build?

    Build a support tool that reads customer emails and automatically issues refunds.

    Review my build Local matching; optional AI is separate.
  2. 02 / Detect

    We identify what the system does.

    Published rules look for known traits. You see the list and can correct it before continuing.

    Traits found in your description
    AI componentOutside inputMoney movementCustomer data
    Every trait is yours to correct or remove.
  3. 03 / Match

    Your confirmed traits select the safeguards.

    Published rules decide what applies, and each pack explains why it was selected.

    Safeguards that apply
    • AUT-001
      Bounded AutonomyBecause money can move without a person.
    • AI-001
      Untrusted ContentBecause a model reads text you did not write.
    • OBS-001
      Traceable ActionsBecause someone will have to answer for a refund.
  4. 04 / Decide

    You answer the questions that matter.

    Limits, approvals, and scope stay open until you confirm them. Nothing invents a business value for you.

    AUT-001-Q1 · Threshold

    What is the largest refund an automation may issue without human approval?

    $500Any amountLeave open — a valid answer
    An open decision is recorded as open, and your agent is told to ask.
  5. 05 / Hand off

    Your agent gets clear instructions.

    A directive it can implement, plus the files it uses to report what it built — and what it could not.

    .agentdirective/
    • agent-directive.jsonThe boundaries, as structured rules.
    • AGENTDIRECTIVE.mdThe same thing, for a person to read.
    • control-status.jsonWhere your agent reports what it built.
  6. 06 / Report back

    Your agent records what it built.

    It reports what it implemented, what it could not, and the evidence behind each claim. Reassess the same project later against its directive.

    control-status.json
    • implemented
      APPROVAL_THRESHOLD2 tests named, evidence pointed at.
    • partial
      ACTION_TRAILLimits and remaining work recorded.
    • unresolved
      EXPORT_SCOPEStill yours to decide.
    Reported is not verified, and the report says so.

See the full walkthrough →

Why it helps

Make the important decisions yourself.

A coding agent may make assumptions when a prompt leaves something out. Review the choices that affect authority, data, and failure handling before implementation.

Your decisions stay yours

Confirm the limits, approvals, and scope you know. Leave the rest open. The directive tells your agent to ask before choosing those values.

See why a safeguard applies

Each matched Control Pack links a project trait to a potential failure, an implementation requirement, and supporting sources.

Give your agent useful instructions

The brief includes requirements, tests to run, and a structured way to record progress. Packs with implementation recipes include those too.

Check the reported evidence

An optional follow-up finds missing or inconsistent evidence in your agent’s report. It does not inspect source code or test the running system.

Where to start

Start where you are.

No account, no repository access, no source code. Pick whichever matches where you are.

What this is not

Design guidance, not a security guarantee.

AgentDirective prepares instructions and checks reported metadata. You still need code review and testing to find out whether the implementation follows those instructions.