AGENTS.md — [VENTURE_NAME] (Template)¶
This file is a template. Every bracketed placeholder must be replaced when this scaffold is copied into
ventures/[venture-slug]/. Until replaced, this file describes no real venture and should not be treated as an operating contract for anything.
Purpose¶
This is the AI operating contract for the [VENTURE_NAME] venture
([venture-slug]), a venture of Devonshire Digital LLC. It governs how AI
agents (and humans directing them) should work within this venture's part of
the repository.
Read order — required before doing any work in this venture¶
- Root
AGENTS.md(repository root) — the company-level operating contract. It applies everywhere, including here, and takes precedence over anything in this file. - This file — venture-level rules specific to [VENTURE_NAME].
docs/ai/context.md— condensed venture context for AI agents.docs/ai/context-loading.md— the recommended reading order for deeper venture context (strategy, standards, architecture, decisions).docs/ai/guardrails.md— venture-specific guardrails and things to never do without explicit human approval.- Relevant product-level docs under
products/[product-slug]/, if the task concerns a specific product.
Precedence rule¶
If anything in this file, or in any other [VENTURE_NAME] document, appears to
conflict with the root AGENTS.md or other company-level policy documents,
the company-level document wins. This venture cannot weaken, override, or
carve exceptions out of company-level rules. Any perceived need to do so
should be raised as an open question or a proposed ADR, not resolved
unilaterally inside this venture's documents.
Scope of this venture¶
[Describe in one or two sentences what [VENTURE_NAME] is and is not, once the venture brief is filled in. Until then, leave this as a placeholder.]
Working rules specific to this venture¶
- [Placeholder — venture-specific working rule 1]
- [Placeholder — venture-specific working rule 2]
- [Placeholder — venture-specific working rule 3]
Escalation¶
Questions that cannot be resolved from this venture's own documentation
should be escalated per the process described in the root AGENTS.md, not
guessed at.