Skip to content

[anneal] Reconcile agent documentation authority with top-level principles #3695

Description

@joshlf

Follow-up to #3693 and the staged agent-documentation work in #3489.

Once the top-level Anneal principles land, reconcile the staged V2 documentation hierarchy so that:

  • anneal/PRINCIPLES.md is the shared project-level authority for humans and agents;
  • anneal/AGENTS.md and anneal/agent_docs/README.md route through those principles rather than maintaining a competing top-level principles layer; and
  • anneal/agent_docs/design/principles.md is explicitly subordinate engineering/design guidance (renaming it if useful), with duplicated or conflicting project-level claims removed.

Keep the deeper agent corpus and accepted-decision machinery intact; this issue is about authority and role, not rewriting the design from scratch.

Authored by an AI agent acting on Josh Liebow-Feeser's behalf.

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions