Production agent starter kitReviewed Jul 26, 2026

The files that turn an agent demo into an operating system.

Start with 15 practical Markdown templates for instructions, Skills, architecture, design, specifications, plans, tasks, context, memory, tools, delegation, evals, safety, operations, and decisions. Every file includes fillable evidence fields, a decision rule, related guides, and primary references.

15

reviewed templates

4

lifecycle layers

24

primary references

30 days

maximum review interval

Source-backed

Every template inherits the evidence ledgers of its related reviewed topics.

Regenerated automatically

A deterministic generator rebuilds files and integrity hashes when reviewed records change.

Validated as a system

Coverage, links, frontmatter, word depth, bundle completeness, and SHA-256 hashes must pass.

Project files

Use only the files that close a real gap.

Templates are starting contracts, not paperwork quotas. Remove inapplicable sections, replace every placeholder with evidence, and keep each file linked to the decisions and checks it supports.

01

Direction

Define project rules, desired behavior, implementation sequence, and bounded work.

4 sections

AGENTS.md

Repository agent instructions

Give coding agents the durable project map, commands, conventions, boundaries, and verification steps they need before changing the repository. Keep instructions concrete, scoped, and close to the files they govern.

4 sections

SPEC.md

Feature specification

Turn an intended outcome into testable behavior, requirements, constraints, non-goals, edge cases, and acceptance evidence before selecting implementation details or decomposing the work.

4 sections

PLAN.md

Implementation plan

Translate an approved specification into a reversible technical approach, decision sequence, dependency-aware phases, validation strategy, deployment path, and rollback plan.

4 sections

TASKS.md

Agent-ready task system

Decompose the plan into dependency-ordered work units with explicit inputs, scope, outputs, acceptance checks, ownership, status, and integration evidence suitable for people or delegated agents.

02

Design

Make the experience, system boundaries, context, and memory model explicit.

4 sections

ARCHITECTURE.md

Agent system architecture

Describe system boundaries, responsibilities, data and control flow, trust zones, dependencies, failure behavior, and deployment topology so changes can be evaluated against an explicit operating model.

4 sections

DESIGN.md

Agent product design

Design the human experience around bounded outcomes, visible system state, calibrated uncertainty, approval moments, recovery, and accessibility rather than treating the agent as an unrestricted chat box.

4 sections

CONTEXT.md

Context engineering system

Control which instructions, examples, tools, retrieved facts, messages, and summaries reach the model; record their authority, provenance, freshness, token cost, and intended decision.

4 sections

MEMORY.md

Agent memory system

Define what the system remembers across turns or runs, why each memory type exists, how identity and provenance are preserved, and how information is corrected, expired, deleted, and evaluated.

03

Execution

Contract tools, repeatable Skills, and delegation before agents take action.

4 sections

SKILL.md

Portable Agent Skill

Package one bounded, repeatable workflow with a discoverable trigger, explicit inputs and outputs, ordered instructions, edge-case handling, and validation. Keep supporting references and scripts inspectable.

4 sections

TOOLS.md

Tool and MCP contracts

Inventory model-callable capabilities and make schemas, descriptions, authentication, authorization, side effects, idempotency, errors, timeouts, output limits, and approval requirements explicit.

4 sections

DELEGATION.md

Multi-agent delegation

Define when work may be delegated, which specialized agents exist, what context and authority each receives, how handoffs are structured, and who verifies and synthesizes the returned work.

04

Assurance

Gate releases with evaluation, safety, operations, and traceable decisions.

4 sections

EVALS.md

Agent evaluation system

Define representative tasks, outcomes, failure taxonomies, graders, human review, operational metrics, release thresholds, and regression processes for behavior that varies across models and environments.

4 sections

SAFETY.md

Safety and permission system

Document threats, assets, identities, authority boundaries, least-privilege controls, approval policies, data protections, abuse cases, and incident response for agent behavior and tool use.

4 sections

RUNBOOK.md

Agent operations runbook

Give operators a tested path from alert to diagnosis, containment, rollback, recovery, communication, and follow-up using the signals and failure modes of the complete agent workflow.

4 sections

DECISIONS.md

Architecture decision log

Keep important product, model, architecture, data, protocol, safety, and operating decisions traceable to context, alternatives, evidence, consequences, owners, and review triggers.