{"schemaVersion":1,"id":"agentatlas-production-agent-starter-kit","name":"AgentAtlas Production Agent Starter Kit","canonicalUrl":"https://agentatlas.dev/starter-kit","reviewedAt":"2026-07-26","reviewCadenceDays":30,"generatorVersion":"1.0.0","editorialPolicy":"Templates are generated deterministically from reviewed AgentAtlas records. Automation may format and package approved guidance, but it may not invent requirements, silently rewrite decision rules, or let commercial relationships influence the contents.","templateCount":15,"templates":[{"slug":"agent-instructions","fileName":"AGENTS.md","title":"Repository agent instructions","category":"Direction","summary":"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.","decisionRule":"Put stable repository-wide operating guidance in AGENTS.md. Move task-specific procedures into Skills and feature-specific intent into specifications, plans, or task records.","topicSlugs":["agents","specifications","safety-permissions"],"sections":[{"heading":"Project map","guidance":"Orient an agent without forcing it to rediscover the repository or infer ownership.","fields":[{"label":"Purpose","prompt":"Describe the product and the outcome this repository owns"},{"label":"Important paths","prompt":"List the directories, packages, generated files, and ownership boundaries that matter"},{"label":"Instruction scope","prompt":"Explain whether nested AGENTS.md files override guidance for subprojects"}]},{"heading":"Commands and environment","guidance":"Provide exact, non-interactive commands and identify prerequisites that cannot be inferred safely.","fields":[{"label":"Install","prompt":"Give the dependency installation command and required runtime versions"},{"label":"Develop","prompt":"Give the local development command and expected URL or process"},{"label":"Verify","prompt":"List focused tests, full tests, type checks, linting, and build commands"}]},{"heading":"Conventions and change policy","guidance":"State the rules that meaningfully affect implementation and review.","fields":[{"label":"Code conventions","prompt":"Name architecture, style, naming, and dependency rules with examples where useful"},{"label":"Generated or protected files","prompt":"Identify files agents must not hand-edit or overwrite"},{"label":"Change boundaries","prompt":"Describe acceptable scope, compatibility expectations, migrations, and documentation updates"}]},{"heading":"Safety and completion","guidance":"Make consequential actions and the definition of done explicit.","fields":[{"label":"Approval required","prompt":"List external writes, deployments, secrets, destructive changes, or costs that require approval"},{"label":"Security","prompt":"State data-handling, authorization, dependency, and secret-management requirements"},{"label":"Done","prompt":"Define the evidence an agent must return before claiming the task is complete"}]}],"canonicalUrl":"https://agentatlas.dev/starter-kit/agent-instructions","downloadUrl":"https://agentatlas.dev/starter-kit/files/AGENTS.md","sources":[{"label":"Building effective agents","publisher":"Anthropic","url":"https://www.anthropic.com/engineering/building-effective-agents","supports":"The distinction between fixed workflows and model-directed agents, plus the recommendation to add complexity only when measured outcomes justify it."},{"label":"Running agents","publisher":"OpenAI","url":"https://openai.github.io/openai-agents-python/running_agents/","supports":"Agent run loops, state management, continuation strategies, and the operational boundary between the SDK and application-owned state."},{"label":"GitHub Spec Kit","publisher":"GitHub","url":"https://github.github.com/spec-kit/index.html","supports":"The specification-driven workflow from intent through specification, plan, tasks, implementation, and quality checks."},{"label":"AGENTS.md specification","publisher":"AGENTS.md","url":"https://agents.md/","supports":"Portable repository-level instructions that keep implementation constraints and verification commands available to coding agents."},{"label":"Codex security","publisher":"OpenAI","url":"https://developers.openai.com/codex/security","supports":"Sandboxing, approvals, network access, filesystem controls, and security boundaries for agentic coding work."},{"label":"Configure permissions","publisher":"Anthropic","url":"https://code.claude.com/docs/en/permissions","supports":"Permission rules, allow and deny controls, managed policy, tool authorization, and least-privilege configuration."}]},{"slug":"agent-skill","fileName":"SKILL.md","title":"Portable Agent Skill","category":"Execution","summary":"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.","decisionRule":"Create a Skill when the same specialized workflow should activate on demand across tasks or projects. Keep durable repository rules in AGENTS.md and one-off work in the task itself.","topicSlugs":["skills","tasks","tools-mcp"],"frontMatter":{"name":"example-skill","description":"Performs one bounded, repeatable workflow. Use when the requested task matches the workflow described in this Skill.","metadata":{"version":"0.1.0"}},"sections":[{"heading":"Trigger and outcome","guidance":"Make it easy for an agent to decide when the Skill applies and what successful completion means.","fields":[{"label":"Use when","prompt":"List the user phrases, file types, or task conditions that should activate this Skill"},{"label":"Do not use when","prompt":"Name nearby tasks that require a different workflow or human judgment"},{"label":"Outcome","prompt":"Describe the verifiable artifact or state this Skill produces"}]},{"heading":"Inputs and outputs","guidance":"Declare required context and a stable return contract before the procedure.","fields":[{"label":"Required inputs","prompt":"List files, parameters, credentials, and assumptions the workflow needs"},{"label":"Output contract","prompt":"Define files, structured fields, messages, or evidence returned"},{"label":"Dependencies","prompt":"List optional scripts, references, assets, tools, and environment requirements"}]},{"heading":"Procedure","guidance":"Write ordered steps with decision points, checkpoints, and the smallest safe tool scope.","fields":[{"label":"Prepare","prompt":"Describe read-only discovery and precondition checks"},{"label":"Execute","prompt":"List the ordered implementation steps and allowed tools"},{"label":"Verify","prompt":"State the checks that must pass before returning the result"}]},{"heading":"Failures and progressive disclosure","guidance":"Keep the main file focused while making recovery and deeper material discoverable.","fields":[{"label":"Edge cases","prompt":"List ambiguous, malformed, missing, or unsafe inputs and the required response"},{"label":"Recovery","prompt":"Explain retry limits, cleanup, rollback, and escalation"},{"label":"References","prompt":"Link focused files under references, scripts, or assets using relative paths"}]}],"canonicalUrl":"https://agentatlas.dev/starter-kit/agent-skill","downloadUrl":"https://agentatlas.dev/starter-kit/files/SKILL.md","sources":[{"label":"Agent Skills specification","publisher":"Agent Skills","url":"https://agentskills.io/specification","supports":"The portable Skill directory structure, required SKILL.md metadata, progressive disclosure, and optional resource folders."},{"label":"Build skills for ChatGPT and Codex","publisher":"OpenAI","url":"https://learn.chatgpt.com/docs/build-skills","supports":"How Skills are authored, discovered, loaded, and used across OpenAI agent surfaces."},{"label":"Agentic SDD workflow","publisher":"GitHub","url":"https://github.github.com/spec-kit/reference/agentic-sdd.html","supports":"Generating and analyzing implementation tasks after specification and planning quality gates."},{"label":"A2A protocol specification","publisher":"A2A Project","url":"https://a2a-protocol.org/latest/specification/","supports":"Task identity, lifecycle, messages, status, artifacts, cancellation, and communication across agent boundaries."},{"label":"MCP specification","publisher":"Model Context Protocol","url":"https://modelcontextprotocol.io/specification/","supports":"The protocol model, capability negotiation, tools, resources, prompts, transports, authorization, and security considerations."},{"label":"Connect Codex to MCP servers","publisher":"OpenAI","url":"https://learn.chatgpt.com/docs/extend/mcp","supports":"How Codex discovers, configures, authenticates, and uses MCP servers and their capabilities."}]},{"slug":"architecture","fileName":"ARCHITECTURE.md","title":"Agent system architecture","category":"Design","summary":"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.","decisionRule":"Use architecture documentation for durable system structure and cross-cutting constraints. Keep user-facing interaction detail in DESIGN.md and feature-specific implementation choices in PLAN.md.","topicSlugs":["architecture","tools-mcp","deployment-operations"],"sections":[{"heading":"Scope and boundaries","guidance":"State what the system owns, what it delegates, and where trust or organizational responsibility changes.","fields":[{"label":"System purpose","prompt":"Describe the outcomes and users this architecture supports"},{"label":"In scope","prompt":"List owned capabilities and data"},{"label":"External boundaries","prompt":"List providers, agents, tools, protocols, and teams outside the boundary"}]},{"heading":"Components and flows","guidance":"Make runtime responsibilities and important state transitions inspectable.","fields":[{"label":"Components","prompt":"List each component, owner, responsibility, and interface"},{"label":"Data flow","prompt":"Describe inputs, persisted state, context assembly, outputs, and sensitive data movement"},{"label":"Control flow","prompt":"Describe orchestration, delegation, approvals, retries, and termination"}]},{"heading":"Quality attributes and decisions","guidance":"Connect architecture choices to measurable constraints instead of framework preference.","fields":[{"label":"Targets","prompt":"Record reliability, latency, cost, security, privacy, and scale objectives"},{"label":"Key decisions","prompt":"Link the decision records that justify important tradeoffs"},{"label":"Constraints","prompt":"State provider, compliance, deployment, compatibility, and team constraints"}]},{"heading":"Operations and evolution","guidance":"Explain how the system fails, recovers, changes, and proves compatibility.","fields":[{"label":"Failure modes","prompt":"List dependency, model, tool, data, queue, and authorization failures"},{"label":"Deployment","prompt":"Describe environments, release units, migration order, and rollback"},{"label":"Evolution","prompt":"Define compatibility promises, deprecation, and architecture review triggers"}]}],"canonicalUrl":"https://agentatlas.dev/starter-kit/architecture","downloadUrl":"https://agentatlas.dev/starter-kit/files/ARCHITECTURE.md","sources":[{"label":"Building effective agents","publisher":"Anthropic","url":"https://www.anthropic.com/engineering/building-effective-agents","supports":"Composable workflow patterns, the workflow-versus-agent boundary, and the case for starting with simpler architecture."},{"label":"A2A protocol specification","publisher":"A2A Project","url":"https://a2a-protocol.org/latest/specification/","supports":"Architecture for communication between independently operated agents, including discovery, tasks, messages, artifacts, and security schemes."},{"label":"MCP specification","publisher":"Model Context Protocol","url":"https://modelcontextprotocol.io/specification/","supports":"The protocol model, capability negotiation, tools, resources, prompts, transports, authorization, and security considerations."},{"label":"Connect Codex to MCP servers","publisher":"OpenAI","url":"https://learn.chatgpt.com/docs/extend/mcp","supports":"How Codex discovers, configures, authenticates, and uses MCP servers and their capabilities."},{"label":"Running agents","publisher":"OpenAI","url":"https://openai.github.io/openai-agents-python/running_agents/","supports":"Run execution, limits, state and conversation strategies, streaming, errors, and lifecycle behavior."},{"label":"OpenAI Agents SDK tracing","publisher":"OpenAI","url":"https://openai.github.io/openai-agents-python/tracing/","supports":"Production workflow tracing, grouping, processors, sensitive data, and operational diagnosis."}]},{"slug":"product-design","fileName":"DESIGN.md","title":"Agent product design","category":"Design","summary":"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.","decisionRule":"Use DESIGN.md to specify user interaction, feedback, control, and recovery. Keep system boundaries in architecture and implementation sequencing in the plan.","topicSlugs":["agent-product-design","human-approval","safety-permissions"],"sections":[{"heading":"Users, jobs, and outcomes","guidance":"Anchor the experience in a real user job and an observable, verifiable measure of success.","fields":[{"label":"Primary user","prompt":"Describe role, expertise, incentives, and constraints"},{"label":"Job","prompt":"State the workflow and current pain without prescribing a solution"},{"label":"Outcome","prompt":"Define what the user can verify when the experience succeeds"}]},{"heading":"Interaction and system state","guidance":"Show what the system knows, plans, is doing, and needs from the user.","fields":[{"label":"Entry points","prompt":"List triggers, inputs, defaults, and required context"},{"label":"State model","prompt":"Define idle, preparing, running, waiting, failed, canceled, and completed states"},{"label":"Feedback","prompt":"Describe progress, evidence, uncertainty, and tool activity shown to the user"}]},{"heading":"Control and trust","guidance":"Place human judgment where authority or consequence changes.","fields":[{"label":"Approvals","prompt":"Name actions requiring preview, confirmation, or a second reviewer"},{"label":"Corrections","prompt":"Explain edit, retry, undo, cancel, and feedback behavior"},{"label":"Disclosure","prompt":"State how sources, sponsorship, limitations, and automation are labeled"}]},{"heading":"Edge states and accessibility","guidance":"Design realistic failure and alternate-access paths before polish.","fields":[{"label":"Empty and partial states","prompt":"Describe missing context, no results, incomplete outputs, and degraded dependencies"},{"label":"Failure recovery","prompt":"Define actionable messages, retained work, escalation, and safe fallback"},{"label":"Accessibility","prompt":"Record keyboard, screen-reader, contrast, motion, focus, and language requirements"}]}],"canonicalUrl":"https://agentatlas.dev/starter-kit/product-design","downloadUrl":"https://agentatlas.dev/starter-kit/files/DESIGN.md","sources":[{"label":"Human-in-the-loop","publisher":"OpenAI","url":"https://openai.github.io/openai-agents-python/human_in_the_loop/","supports":"Approval-required tools, interruptions, rejection messages, persisted run state, resumption, and long-running approvals."},{"label":"Building effective agents","publisher":"Anthropic","url":"https://www.anthropic.com/engineering/building-effective-agents","supports":"Transparency, explicit planning, tool-interface design, and choosing agentic complexity only when it improves outcomes."},{"label":"Configure permissions","publisher":"Anthropic","url":"https://code.claude.com/docs/en/permissions","supports":"Permission rules, allow and deny controls, managed policy, tool authorization, and least-privilege configuration."},{"label":"Codex security","publisher":"OpenAI","url":"https://developers.openai.com/codex/security","supports":"Sandboxing, approvals, network access, filesystem controls, and security boundaries for agentic coding work."}]},{"slug":"specification","fileName":"SPEC.md","title":"Feature specification","category":"Direction","summary":"Turn an intended outcome into testable behavior, requirements, constraints, non-goals, edge cases, and acceptance evidence before selecting implementation details or decomposing the work.","decisionRule":"Specify what and why before deciding how. If a statement cannot be verified, clarified, or traced to a user outcome, tighten it before planning.","topicSlugs":["specifications","agent-product-design","evals-verification"],"sections":[{"heading":"Problem and outcome","guidance":"Define the user-visible change and the evidence that it matters.","fields":[{"label":"Problem","prompt":"Describe the current workflow, pain, and affected user"},{"label":"Desired outcome","prompt":"State the observable behavior or state change"},{"label":"Success measures","prompt":"List product, quality, safety, and operational measures"}]},{"heading":"Requirements and scenarios","guidance":"Write behavior precisely enough that each scenario can become an objective acceptance test.","fields":[{"label":"Primary scenarios","prompt":"List trigger, inputs, expected behavior, and output for each core path"},{"label":"Edge scenarios","prompt":"Cover missing, malformed, conflicting, unauthorized, canceled, and repeated actions"},{"label":"Data","prompt":"Define required fields, provenance, retention, correction, and deletion"}]},{"heading":"Constraints and non-goals","guidance":"Prevent the implementation from silently expanding or violating a hard boundary.","fields":[{"label":"Constraints","prompt":"State security, privacy, compatibility, latency, cost, and compliance limits"},{"label":"Non-goals","prompt":"List plausible adjacent work explicitly excluded"},{"label":"Open questions","prompt":"Record unresolved ambiguity, owner, and deadline for each answer"}]},{"heading":"Acceptance and traceability","guidance":"Connect each requirement to evidence and later implementation work.","fields":[{"label":"Acceptance checks","prompt":"Write objective checks for every required behavior and important failure path"},{"label":"Approval","prompt":"Name the product, design, security, legal, or operations reviewers required"},{"label":"Traceability","prompt":"Link plan decisions, tasks, tests, eval cases, telemetry, and release evidence"}]}],"canonicalUrl":"https://agentatlas.dev/starter-kit/specification","downloadUrl":"https://agentatlas.dev/starter-kit/files/SPEC.md","sources":[{"label":"GitHub Spec Kit","publisher":"GitHub","url":"https://github.github.com/spec-kit/index.html","supports":"The specification-driven workflow from intent through specification, plan, tasks, implementation, and quality checks."},{"label":"AGENTS.md specification","publisher":"AGENTS.md","url":"https://agents.md/","supports":"Portable repository-level instructions that keep implementation constraints and verification commands available to coding agents."},{"label":"Human-in-the-loop","publisher":"OpenAI","url":"https://openai.github.io/openai-agents-python/human_in_the_loop/","supports":"Pause, inspect, approve, reject, persist, and resume patterns for consequential tool calls across agent runs."},{"label":"Building effective agents","publisher":"Anthropic","url":"https://www.anthropic.com/engineering/building-effective-agents","supports":"Transparency, explicit planning, tool-interface design, and choosing agentic complexity only when it improves outcomes."},{"label":"Evaluation best practices","publisher":"OpenAI","url":"https://developers.openai.com/api/docs/guides/evaluation-best-practices","supports":"Eval design, task-specific datasets, graders, continuous evaluation, and avoiding common measurement mistakes."},{"label":"Demystifying evals for AI agents","publisher":"Anthropic","url":"https://www.anthropic.com/engineering/demystifying-evals-for-ai-agents","supports":"Agent-specific evaluation design, outcome and process measures, transcript analysis, and iterative improvement."}]},{"slug":"implementation-plan","fileName":"PLAN.md","title":"Implementation plan","category":"Direction","summary":"Translate an approved specification into a reversible technical approach, decision sequence, dependency-aware phases, validation strategy, deployment path, and rollback plan.","decisionRule":"Plan the smallest sequence that proves the riskiest assumptions early. Keep the plan linked to the specification and regenerate tasks when the approach changes materially.","topicSlugs":["planning","architecture","deployment-operations"],"sections":[{"heading":"Approach and decisions","guidance":"Explain the implementation strategy and why it satisfies the specification.","fields":[{"label":"Approach","prompt":"Summarize components, data changes, interfaces, and control flow"},{"label":"Key decisions","prompt":"Record selected options, alternatives, tradeoffs, and evidence"},{"label":"Assumptions","prompt":"List assumptions to prove before broad implementation"}]},{"heading":"Phases and dependencies","guidance":"Sequence work around risk, independently verifiable outputs, and real blockers.","fields":[{"label":"Foundation","prompt":"List blocking setup, schemas, contracts, and test harnesses"},{"label":"Vertical slices","prompt":"Define incremental user-visible or end-to-end capabilities"},{"label":"Dependency order","prompt":"Map blockers, parallel work, integration points, and owners"}]},{"heading":"Verification and rollout","guidance":"Decide how each phase proves correctness before work begins.","fields":[{"label":"Verification","prompt":"Map unit, integration, end-to-end, eval, security, and manual checks to phases"},{"label":"Observability","prompt":"Name logs, metrics, traces, dashboards, and release signals"},{"label":"Rollout","prompt":"Describe migration, feature flags, cohorts, compatibility, and success gates"}]},{"heading":"Risk and recovery","guidance":"Make failure containment and plan updates part of the implementation.","fields":[{"label":"Risks","prompt":"Rank technical, product, safety, privacy, cost, and schedule risks"},{"label":"Mitigations","prompt":"Assign preventive controls, owners, evidence, and review dates"},{"label":"Rollback","prompt":"Define stop conditions, reversible steps, data recovery, and communication"}]}],"canonicalUrl":"https://agentatlas.dev/starter-kit/implementation-plan","downloadUrl":"https://agentatlas.dev/starter-kit/files/PLAN.md","sources":[{"label":"Agentic SDD workflow","publisher":"GitHub","url":"https://github.github.com/spec-kit/reference/agentic-sdd.html","supports":"The ordered specification, clarification, planning, tasking, analysis, implementation, and convergence workflow."},{"label":"Building effective agents","publisher":"Anthropic","url":"https://www.anthropic.com/engineering/building-effective-agents","supports":"Composable workflow patterns, the workflow-versus-agent boundary, and the case for starting with simpler architecture."},{"label":"A2A protocol specification","publisher":"A2A Project","url":"https://a2a-protocol.org/latest/specification/","supports":"Architecture for communication between independently operated agents, including discovery, tasks, messages, artifacts, and security schemes."},{"label":"Running agents","publisher":"OpenAI","url":"https://openai.github.io/openai-agents-python/running_agents/","supports":"Run execution, limits, state and conversation strategies, streaming, errors, and lifecycle behavior."},{"label":"OpenAI Agents SDK tracing","publisher":"OpenAI","url":"https://openai.github.io/openai-agents-python/tracing/","supports":"Production workflow tracing, grouping, processors, sensitive data, and operational diagnosis."}]},{"slug":"task-system","fileName":"TASKS.md","title":"Agent-ready task system","category":"Direction","summary":"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.","decisionRule":"Create a separate task only when its output can be verified independently or its ownership and dependencies need explicit coordination. Avoid task fragmentation without a review boundary.","topicSlugs":["tasks","planning","multi-agent"],"sections":[{"heading":"Task contract","guidance":"Use the same minimum outcome, scope, and verification contract for every work item.","fields":[{"label":"Outcome","prompt":"State the artifact or state change that completes the task"},{"label":"Inputs and scope","prompt":"List required context, allowed paths, dependencies, and explicit exclusions"},{"label":"Acceptance","prompt":"Define commands, tests, inspection, or evidence that verifies the output"}]},{"heading":"Phases and dependencies","guidance":"Keep the executable queue aligned with the plan and specification.","fields":[{"label":"Setup","prompt":"List environment and harness tasks that unblock later work"},{"label":"Foundational","prompt":"List shared contracts, data, security, and architecture tasks"},{"label":"Delivery phases","prompt":"Group vertical work by user outcome and mark parallel-safe tasks"}]},{"heading":"Work queue","guidance":"Make state, ownership, and handoffs visible without hiding unfinished work.","fields":[{"label":"Ready","prompt":"List unblocked tasks with owner and priority"},{"label":"In progress","prompt":"List active tasks, current evidence, and blocking questions"},{"label":"Done","prompt":"Record verification evidence, integration result, and links to changes"}]},{"heading":"Integration and convergence","guidance":"Check the complete integrated outcome after every individual task and local verification passes.","fields":[{"label":"Integration order","prompt":"State merge, migration, release, and cross-task verification order"},{"label":"Gap analysis","prompt":"Compare completed work with the specification, plan, and acceptance checks"},{"label":"Follow-up","prompt":"Append discovered gaps with owners rather than hiding them in completion notes"}]}],"canonicalUrl":"https://agentatlas.dev/starter-kit/task-system","downloadUrl":"https://agentatlas.dev/starter-kit/files/TASKS.md","sources":[{"label":"Agentic SDD workflow","publisher":"GitHub","url":"https://github.github.com/spec-kit/reference/agentic-sdd.html","supports":"The ordered specification, clarification, planning, tasking, analysis, implementation, and convergence workflow."},{"label":"A2A protocol specification","publisher":"A2A Project","url":"https://a2a-protocol.org/latest/specification/","supports":"Task identity, lifecycle, messages, status, artifacts, cancellation, and communication across agent boundaries."},{"label":"Building effective agents","publisher":"Anthropic","url":"https://www.anthropic.com/engineering/building-effective-agents","supports":"Planning transparency, composable workflow patterns, and matching orchestration complexity to task requirements."},{"label":"Codex subagents","publisher":"OpenAI","url":"https://learn.chatgpt.com/docs/agent-configuration/subagents","supports":"Subagent configuration, scoped roles, delegation behavior, and parallel work inside Codex."},{"label":"Create custom subagents","publisher":"Anthropic","url":"https://code.claude.com/docs/en/sub-agents","supports":"Specialized subagent configuration, context isolation, tools, permissions, and delegation patterns."}]},{"slug":"context-system","fileName":"CONTEXT.md","title":"Context engineering system","category":"Design","summary":"Control which instructions, examples, tools, retrieved facts, messages, and summaries reach the model; record their authority, provenance, freshness, token cost, and intended decision.","decisionRule":"Include context only when it changes a named decision or reduces a measured failure. Retrieve current authoritative evidence instead of accumulating every available token.","topicSlugs":["context-engineering","memory-context","safety-permissions"],"sections":[{"heading":"Context inventory","guidance":"Identify every source of runtime tokens and the specific decision or behavior it supports.","fields":[{"label":"Always loaded","prompt":"List system instructions, repository policy, schemas, and stable constraints"},{"label":"Retrieved","prompt":"List knowledge stores, search, tools, ranking, and freshness requirements"},{"label":"Runtime","prompt":"List user input, session history, tool output, scratch state, and summaries"}]},{"heading":"Selection and budget","guidance":"Prioritize relevant and authoritative context under realistic limits.","fields":[{"label":"Budget","prompt":"Allocate tokens or size limits by instruction, history, retrieval, tools, and output"},{"label":"Ranking","prompt":"Define relevance, authority, recency, diversity, and conflict rules"},{"label":"Compaction","prompt":"Describe summarization, truncation, checkpointing, and information that must survive"}]},{"heading":"Provenance and conflict","guidance":"Make it possible to inspect why information was present and which source wins.","fields":[{"label":"Provenance","prompt":"Attach source, owner, timestamp, version, and retrieval reason"},{"label":"Authority order","prompt":"Define precedence for user intent, project policy, retrieved evidence, and model inference"},{"label":"Sensitive context","prompt":"State redaction, isolation, retention, and export restrictions"}]},{"heading":"Evaluation","guidance":"Measure whether the context system helps rather than assuming more is better.","fields":[{"label":"Quality","prompt":"Test retrieval precision, groundedness, conflict resolution, and task success"},{"label":"Efficiency","prompt":"Measure tokens, latency, cache effectiveness, and repeated retrieval"},{"label":"Failure cases","prompt":"Test stale facts, prompt injection, distraction, compaction loss, and missing context"}]}],"canonicalUrl":"https://agentatlas.dev/starter-kit/context-system","downloadUrl":"https://agentatlas.dev/starter-kit/files/CONTEXT.md","sources":[{"label":"Effective context engineering for AI agents","publisher":"Anthropic","url":"https://www.anthropic.com/engineering/effective-context-engineering-for-ai-agents","supports":"Treating context as a finite resource and curating instructions, tools, external data, history, and summaries across long-running agents."},{"label":"How Claude remembers your project","publisher":"Anthropic","url":"https://code.claude.com/docs/en/memory","supports":"Repository instruction hierarchy, project memory, scoped rules, and how persistent context is discovered and loaded."},{"label":"Sessions","publisher":"OpenAI","url":"https://openai.github.io/openai-agents-python/sessions/","supports":"Session memory, storage choices, history limits, compaction, resumption, and operational persistence patterns."},{"label":"Codex security","publisher":"OpenAI","url":"https://developers.openai.com/codex/security","supports":"Sandboxing, approvals, network access, filesystem controls, and security boundaries for agentic coding work."},{"label":"Configure permissions","publisher":"Anthropic","url":"https://code.claude.com/docs/en/permissions","supports":"Permission rules, allow and deny controls, managed policy, tool authorization, and least-privilege configuration."}]},{"slug":"memory-system","fileName":"MEMORY.md","title":"Agent memory system","category":"Design","summary":"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.","decisionRule":"Persist information only when it has a defined future use, owner, retention rule, and correction path. Do not treat a conversation transcript as an undifferentiated memory system.","topicSlugs":["memory-context","governance","safety-permissions"],"sections":[{"heading":"Memory taxonomy","guidance":"Separate state with different authority, lifetime, and privacy properties.","fields":[{"label":"Session state","prompt":"Define transient conversation and workflow state"},{"label":"Durable facts","prompt":"Define user, project, organizational, and domain knowledge worth persisting"},{"label":"Derived memory","prompt":"Define summaries, preferences, patterns, and their confidence or source"}]},{"heading":"Identity and storage","guidance":"Prevent memory from crossing the wrong user, workspace, tenant, or authority boundary.","fields":[{"label":"Identity keys","prompt":"Define user, session, project, tenant, and agent identifiers"},{"label":"Storage","prompt":"List systems of record, indexes, encryption, access policy, and backups"},{"label":"Retrieval","prompt":"Define queries, ranking, scope, confidence, and empty-result behavior"}]},{"heading":"Lifecycle and control","guidance":"Give users and operators meaningful control over remembered information.","fields":[{"label":"Write policy","prompt":"State what can be written automatically and what requires confirmation"},{"label":"Correction","prompt":"Describe inspection, edit, contradiction, source update, and invalidation"},{"label":"Retention","prompt":"Define expiration, deletion, legal hold, export, and downstream cleanup"}]},{"heading":"Quality and privacy","guidance":"Evaluate benefits and harms using realistic longitudinal cases.","fields":[{"label":"Quality tests","prompt":"Measure retrieval precision, stale-memory behavior, correction, and compaction loss"},{"label":"Privacy tests","prompt":"Test tenant isolation, consent, sensitive inference, deletion, and data minimization"},{"label":"Operational signals","prompt":"Monitor write volume, retrieval use, conflicts, corrections, and deletion failures"}]}],"canonicalUrl":"https://agentatlas.dev/starter-kit/memory-system","downloadUrl":"https://agentatlas.dev/starter-kit/files/MEMORY.md","sources":[{"label":"Sessions","publisher":"OpenAI","url":"https://openai.github.io/openai-agents-python/sessions/","supports":"Session memory, storage choices, history limits, compaction, resumption, and operational persistence patterns."},{"label":"Effective context engineering for AI agents","publisher":"Anthropic","url":"https://www.anthropic.com/engineering/effective-context-engineering-for-ai-agents","supports":"Treating context as a finite resource and curating instructions, tools, external data, history, and summaries across long-running agents."},{"label":"AGENTS.md specification","publisher":"AGENTS.md","url":"https://agents.md/","supports":"Versioned repository instructions that make build, test, style, and contribution requirements available to agents."},{"label":"GitHub Spec Kit","publisher":"GitHub","url":"https://github.github.com/spec-kit/index.html","supports":"Governed specification-driven workflows, quality checks, organizational principles, and traceability across delivery artifacts."},{"label":"Codex security","publisher":"OpenAI","url":"https://developers.openai.com/codex/security","supports":"Sandboxing, approvals, network access, filesystem controls, and security boundaries for agentic coding work."},{"label":"Configure permissions","publisher":"Anthropic","url":"https://code.claude.com/docs/en/permissions","supports":"Permission rules, allow and deny controls, managed policy, tool authorization, and least-privilege configuration."}]},{"slug":"tool-contracts","fileName":"TOOLS.md","title":"Tool and MCP contracts","category":"Execution","summary":"Inventory model-callable capabilities and make schemas, descriptions, authentication, authorization, side effects, idempotency, errors, timeouts, output limits, and approval requirements explicit.","decisionRule":"Expose the narrowest capability that supports a named workflow. Use MCP for reusable cross-system access and ordinary application functions for capabilities owned inside one product boundary.","topicSlugs":["tools-mcp","safety-permissions","observability"],"sections":[{"heading":"Tool inventory and contract","guidance":"Make tool selection and consequences understandable to both models and reviewers.","fields":[{"label":"Capability","prompt":"Name the user outcome and why a model needs this tool"},{"label":"Schema","prompt":"Define narrow typed inputs, outputs, defaults, and validation"},{"label":"Side effects","prompt":"Classify read-only, reversible, external write, financial, destructive, or privileged behavior"}]},{"heading":"Identity and authority","guidance":"Keep authentication separate from the permission to perform a specific action.","fields":[{"label":"Authentication","prompt":"Define caller, user, service, tenant, and credential lifecycle"},{"label":"Authorization","prompt":"Define resource- and action-level policy checked at execution time"},{"label":"Approval","prompt":"List arguments and actions requiring preview, confirmation, or a second reviewer"}]},{"heading":"Reliability and observability","guidance":"Specify predictable behavior under repetition, delay, partial failure, and large outputs.","fields":[{"label":"Failure contract","prompt":"Define typed errors, retryability, timeout, cancellation, and partial results"},{"label":"Idempotency","prompt":"Define duplicate detection, keys, replay, and exactly-once assumptions"},{"label":"Telemetry","prompt":"Record tool name, sanitized arguments, authorization, latency, result, and correlation identifiers"}]},{"heading":"Verification","guidance":"Test the contract as adversarially as the model and external systems will use it.","fields":[{"label":"Contract tests","prompt":"Cover valid, malformed, boundary, oversized, and unsupported inputs"},{"label":"Safety tests","prompt":"Cover prompt injection, confused deputy, cross-tenant, approval bypass, and revocation"},{"label":"Operational tests","prompt":"Cover timeout, retry, duplicate execution, dependency failure, and recovery"}]}],"canonicalUrl":"https://agentatlas.dev/starter-kit/tool-contracts","downloadUrl":"https://agentatlas.dev/starter-kit/files/TOOLS.md","sources":[{"label":"MCP specification","publisher":"Model Context Protocol","url":"https://modelcontextprotocol.io/specification/","supports":"The protocol model, capability negotiation, tools, resources, prompts, transports, authorization, and security considerations."},{"label":"Connect Codex to MCP servers","publisher":"OpenAI","url":"https://learn.chatgpt.com/docs/extend/mcp","supports":"How Codex discovers, configures, authenticates, and uses MCP servers and their capabilities."},{"label":"Codex security","publisher":"OpenAI","url":"https://developers.openai.com/codex/security","supports":"Sandboxing, approvals, network access, filesystem controls, and security boundaries for agentic coding work."},{"label":"Configure permissions","publisher":"Anthropic","url":"https://code.claude.com/docs/en/permissions","supports":"Permission rules, allow and deny controls, managed policy, tool authorization, and least-privilege configuration."},{"label":"OpenTelemetry semantic conventions","publisher":"OpenTelemetry","url":"https://opentelemetry.io/docs/specs/semconv/","supports":"Standard names, attributes, traces, metrics, logs, and generative-AI operations for interoperable telemetry."},{"label":"OpenAI Agents SDK tracing","publisher":"OpenAI","url":"https://openai.github.io/openai-agents-python/tracing/","supports":"Tracing model generations, tools, handoffs, guardrails, custom events, workflow grouping, and sensitive-data controls."}]},{"slug":"delegation","fileName":"DELEGATION.md","title":"Multi-agent delegation","category":"Execution","summary":"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.","decisionRule":"Delegate only when a subtask has a bounded input and independently verifiable output or requires a distinct trust boundary. Keep tightly coupled reasoning in one context.","topicSlugs":["multi-agent","tasks","agents"],"sections":[{"heading":"Delegation policy","guidance":"Prevent multi-agent coordination cost and fragmented context from becoming the default architecture.","fields":[{"label":"Delegate when","prompt":"List clean partitions, expertise needs, isolation, or parallelism that justify delegation"},{"label":"Do not delegate when","prompt":"List shared-state, tightly coupled, high-context, or authority-sensitive work"},{"label":"Budget","prompt":"Define maximum agents, turns, time, tokens, cost, and retry limits"}]},{"heading":"Agent roster","guidance":"Describe specialization without granting unnecessary tools or context.","fields":[{"label":"Role","prompt":"Name each agent's bounded responsibility and expected output"},{"label":"Context","prompt":"List instructions, files, data, and history the agent receives"},{"label":"Authority","prompt":"List tools, resources, writes, approvals, and prohibited actions"}]},{"heading":"Handoff contract","guidance":"Make delegated work reviewable without replaying hidden reasoning.","fields":[{"label":"Input contract","prompt":"Define objective, scope, dependencies, constraints, and acceptance evidence"},{"label":"Return contract","prompt":"Define artifacts, findings, uncertainties, checks, and unresolved blockers"},{"label":"Failure contract","prompt":"Define timeout, partial return, escalation, cancellation, and cleanup"}]},{"heading":"Synthesis and verification","guidance":"Assign responsibility for overlap, contradictions, integration, and whole-system quality.","fields":[{"label":"Synthesizer","prompt":"Name the agent or person that owns the combined result"},{"label":"Conflict resolution","prompt":"Define authority order and evidence required when outputs disagree"},{"label":"Final verification","prompt":"Test the integrated outcome, permissions, traceability, and acceptance checks"}]}],"canonicalUrl":"https://agentatlas.dev/starter-kit/delegation","downloadUrl":"https://agentatlas.dev/starter-kit/files/DELEGATION.md","sources":[{"label":"Codex subagents","publisher":"OpenAI","url":"https://learn.chatgpt.com/docs/agent-configuration/subagents","supports":"Subagent configuration, scoped roles, delegation behavior, and parallel work inside Codex."},{"label":"Create custom subagents","publisher":"Anthropic","url":"https://code.claude.com/docs/en/sub-agents","supports":"Specialized subagent configuration, context isolation, tools, permissions, and delegation patterns."},{"label":"Agentic SDD workflow","publisher":"GitHub","url":"https://github.github.com/spec-kit/reference/agentic-sdd.html","supports":"Generating and analyzing implementation tasks after specification and planning quality gates."},{"label":"A2A protocol specification","publisher":"A2A Project","url":"https://a2a-protocol.org/latest/specification/","supports":"Task identity, lifecycle, messages, status, artifacts, cancellation, and communication across agent boundaries."},{"label":"Building effective agents","publisher":"Anthropic","url":"https://www.anthropic.com/engineering/building-effective-agents","supports":"The distinction between fixed workflows and model-directed agents, plus the recommendation to add complexity only when measured outcomes justify it."},{"label":"Running agents","publisher":"OpenAI","url":"https://openai.github.io/openai-agents-python/running_agents/","supports":"Agent run loops, state management, continuation strategies, and the operational boundary between the SDK and application-owned state."}]},{"slug":"evaluation-system","fileName":"EVALS.md","title":"Agent evaluation system","category":"Assurance","summary":"Define representative tasks, outcomes, failure taxonomies, graders, human review, operational metrics, release thresholds, and regression processes for behavior that varies across models and environments.","decisionRule":"Evaluate the complete workflow against realistic outcomes and failure paths. Use deterministic checks where possible and calibrated human or model judgment where necessary.","topicSlugs":["evals-verification","observability","tasks"],"sections":[{"heading":"Outcomes and failure taxonomy","guidance":"Measure the behavior that matters instead of a convenient proxy.","fields":[{"label":"Success","prompt":"Define task completion, quality, safety, latency, cost, and user-correction outcomes"},{"label":"Failures","prompt":"Classify instruction, context, reasoning, tool, authorization, data, and recovery failures"},{"label":"Severity","prompt":"Define critical, major, minor, and acceptable variance with examples"}]},{"heading":"Evaluation set","guidance":"Represent normal use, boundaries, adversarial cases, and longitudinal behavior.","fields":[{"label":"Cases","prompt":"List source, owner, input, expected evidence, and protected data classification"},{"label":"Coverage","prompt":"Map cases to requirements, tools, users, languages, failures, and risk levels"},{"label":"Versioning","prompt":"Define frozen sets, hidden sets, additions from incidents, and contamination controls"}]},{"heading":"Graders and metrics","guidance":"Make every score interpretable and periodically calibrate judgment.","fields":[{"label":"Deterministic checks","prompt":"List schemas, exact properties, tests, policy checks, and artifact inspection"},{"label":"Judgment","prompt":"Define rubric, human reviewers, model graders, blind review, and disagreement handling"},{"label":"Operational metrics","prompt":"Track completion, correction, retries, tool errors, latency, tokens, cost, and abandonment"}]},{"heading":"Release and regression","guidance":"Turn evaluation into a shipping control rather than a report.","fields":[{"label":"Thresholds","prompt":"Define minimums, critical-case zero tolerance, confidence, and comparison baseline"},{"label":"Release gate","prompt":"State when a change blocks, warns, rolls out gradually, or requires sign-off"},{"label":"Regression loop","prompt":"Add incidents and user corrections, assign owners, and verify fixes across supported models"}]}],"canonicalUrl":"https://agentatlas.dev/starter-kit/evaluation-system","downloadUrl":"https://agentatlas.dev/starter-kit/files/EVALS.md","sources":[{"label":"Evaluation best practices","publisher":"OpenAI","url":"https://developers.openai.com/api/docs/guides/evaluation-best-practices","supports":"Eval design, task-specific datasets, graders, continuous evaluation, and avoiding common measurement mistakes."},{"label":"Demystifying evals for AI agents","publisher":"Anthropic","url":"https://www.anthropic.com/engineering/demystifying-evals-for-ai-agents","supports":"Agent-specific evaluation design, outcome and process measures, transcript analysis, and iterative improvement."},{"label":"OpenTelemetry semantic conventions","publisher":"OpenTelemetry","url":"https://opentelemetry.io/docs/specs/semconv/","supports":"Standard names, attributes, traces, metrics, logs, and generative-AI operations for interoperable telemetry."},{"label":"OpenAI Agents SDK tracing","publisher":"OpenAI","url":"https://openai.github.io/openai-agents-python/tracing/","supports":"Tracing model generations, tools, handoffs, guardrails, custom events, workflow grouping, and sensitive-data controls."},{"label":"Agentic SDD workflow","publisher":"GitHub","url":"https://github.github.com/spec-kit/reference/agentic-sdd.html","supports":"Generating and analyzing implementation tasks after specification and planning quality gates."},{"label":"A2A protocol specification","publisher":"A2A Project","url":"https://a2a-protocol.org/latest/specification/","supports":"Task identity, lifecycle, messages, status, artifacts, cancellation, and communication across agent boundaries."}]},{"slug":"safety-system","fileName":"SAFETY.md","title":"Safety and permission system","category":"Assurance","summary":"Document threats, assets, identities, authority boundaries, least-privilege controls, approval policies, data protections, abuse cases, and incident response for agent behavior and tool use.","decisionRule":"Grant the minimum authority required for the current outcome and re-check authorization at the action boundary. Add human approval when consequences exceed delegated authority.","topicSlugs":["safety-permissions","human-approval","governance"],"sections":[{"heading":"Threat model","guidance":"Identify what must be protected and how the agent can be manipulated or misused.","fields":[{"label":"Assets","prompt":"List data, credentials, money, systems, reputation, and human safety concerns"},{"label":"Actors","prompt":"List users, operators, external content authors, attackers, services, and agents"},{"label":"Threats","prompt":"Cover prompt injection, exfiltration, privilege escalation, fraud, destructive action, and unsafe advice"}]},{"heading":"Identity and permissions","guidance":"Bind every action to an authenticated actor and current resource-level authority.","fields":[{"label":"Identity","prompt":"Define user, service, tenant, session, agent, and delegated identity"},{"label":"Permission model","prompt":"Map roles or attributes to tools, resources, actions, and environments"},{"label":"Credential handling","prompt":"Define issuance, scoping, storage, rotation, revocation, and audit"}]},{"heading":"Approvals and safeguards","guidance":"Use deterministic controls and meaningful approval previews before consequential action.","fields":[{"label":"Approval matrix","prompt":"Map risk tiers to preview, confirmation, second reviewer, or prohibited status"},{"label":"Runtime controls","prompt":"Define allowlists, limits, sandboxing, validation, output filtering, and rate controls"},{"label":"User control","prompt":"Provide inspect, edit, cancel, undo, revoke, delete, and escalation paths"}]},{"heading":"Verification and response","guidance":"Continuously test controls and prepare for containment and recovery.","fields":[{"label":"Safety tests","prompt":"List adversarial, cross-tenant, approval-bypass, data-leak, and unsafe-action cases"},{"label":"Monitoring","prompt":"Define high-risk action, denial, anomaly, policy, and audit signals"},{"label":"Incident response","prompt":"Define containment, credential revocation, evidence preservation, communication, and follow-up"}]}],"canonicalUrl":"https://agentatlas.dev/starter-kit/safety-system","downloadUrl":"https://agentatlas.dev/starter-kit/files/SAFETY.md","sources":[{"label":"Codex security","publisher":"OpenAI","url":"https://developers.openai.com/codex/security","supports":"Operational authority boundaries enforced through sandboxing, permissions, approvals, and network controls."},{"label":"Configure permissions","publisher":"Anthropic","url":"https://code.claude.com/docs/en/permissions","supports":"Permission modes, explicit allow and deny rules, managed controls, and user approval for tool execution."},{"label":"Human-in-the-loop","publisher":"OpenAI","url":"https://openai.github.io/openai-agents-python/human_in_the_loop/","supports":"Approval-required tools, interruptions, rejection messages, persisted run state, resumption, and long-running approvals."},{"label":"AGENTS.md specification","publisher":"AGENTS.md","url":"https://agents.md/","supports":"Versioned repository instructions that make build, test, style, and contribution requirements available to agents."},{"label":"GitHub Spec Kit","publisher":"GitHub","url":"https://github.github.com/spec-kit/index.html","supports":"Governed specification-driven workflows, quality checks, organizational principles, and traceability across delivery artifacts."}]},{"slug":"operations-runbook","fileName":"RUNBOOK.md","title":"Agent operations runbook","category":"Assurance","summary":"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.","decisionRule":"Write a runbook for failures that require timely coordinated action or specialized diagnosis. Keep routine automatic recovery in the system and record its limits here.","topicSlugs":["deployment-operations","observability","human-approval"],"sections":[{"heading":"Service ownership and dependencies","guidance":"Make the operating boundary and escalation path available before an incident.","fields":[{"label":"Owners","prompt":"List primary, secondary, security, data, product, and vendor contacts"},{"label":"Dependencies","prompt":"List models, tools, queues, databases, auth, providers, and critical limits"},{"label":"Environments","prompt":"List production, staging, regions, release identifiers, and access procedure"}]},{"heading":"Signals and diagnosis","guidance":"Connect every alert to a workflow stage, user impact, and known failure mode.","fields":[{"label":"Service indicators","prompt":"Define completion, correctness, safety, latency, cost, and availability signals"},{"label":"Dashboards and traces","prompt":"Link workflow, model, tool, queue, authorization, and business views"},{"label":"Diagnostic sequence","prompt":"List the fastest read-only checks and evidence to preserve"}]},{"heading":"Containment and recovery","guidance":"Provide exact reversible actions with authority and stop conditions.","fields":[{"label":"Contain","prompt":"Define feature disablement, permission revocation, queue pause, isolation, and traffic controls"},{"label":"Rollback","prompt":"Define code, configuration, prompt, model, schema, and data rollback"},{"label":"Recover","prompt":"Define validation, replay, reconciliation, re-enable order, and customer remediation"}]},{"heading":"Communication and learning","guidance":"Keep stakeholders informed and convert failures into maintained controls.","fields":[{"label":"Updates","prompt":"Define internal, user, vendor, legal, and regulatory communication owners and cadence"},{"label":"Closure evidence","prompt":"State the signals and reviewers required to close the incident"},{"label":"Follow-up","prompt":"Add eval cases, tasks, architecture decisions, documentation, and owner deadlines"}]}],"canonicalUrl":"https://agentatlas.dev/starter-kit/operations-runbook","downloadUrl":"https://agentatlas.dev/starter-kit/files/RUNBOOK.md","sources":[{"label":"Running agents","publisher":"OpenAI","url":"https://openai.github.io/openai-agents-python/running_agents/","supports":"Run execution, limits, state and conversation strategies, streaming, errors, and lifecycle behavior."},{"label":"OpenAI Agents SDK tracing","publisher":"OpenAI","url":"https://openai.github.io/openai-agents-python/tracing/","supports":"Tracing model generations, tools, handoffs, guardrails, custom events, workflow grouping, and sensitive-data controls."},{"label":"OpenTelemetry semantic conventions","publisher":"OpenTelemetry","url":"https://opentelemetry.io/docs/specs/semconv/","supports":"Standard names, attributes, traces, metrics, logs, and generative-AI operations for interoperable telemetry."},{"label":"Human-in-the-loop","publisher":"OpenAI","url":"https://openai.github.io/openai-agents-python/human_in_the_loop/","supports":"Approval-required tools, interruptions, rejection messages, persisted run state, resumption, and long-running approvals."},{"label":"Configure permissions","publisher":"Anthropic","url":"https://code.claude.com/docs/en/permissions","supports":"Permission modes, explicit allow and deny rules, managed controls, and user approval for tool execution."}]},{"slug":"decision-log","fileName":"DECISIONS.md","title":"Architecture decision log","category":"Assurance","summary":"Keep important product, model, architecture, data, protocol, safety, and operating decisions traceable to context, alternatives, evidence, consequences, owners, and review triggers.","decisionRule":"Record a decision when reversing it later would be costly, when multiple teams or agents depend on it, or when the tradeoff cannot be understood from code alone.","topicSlugs":["architecture","governance","model-strategy"],"sections":[{"heading":"Decision index","guidance":"Make active, proposed, superseded, and rejected decisions easy to discover.","fields":[{"label":"Identifier","prompt":"Assign a stable ADR or decision number and short title"},{"label":"Status","prompt":"Mark proposed, accepted, deprecated, superseded, or rejected"},{"label":"Ownership","prompt":"Name decider, consulted reviewers, date, and affected systems"}]},{"heading":"Decision record","guidance":"Capture the decision in enough context to understand it later.","fields":[{"label":"Context","prompt":"Describe the problem, constraints, forces, and urgency"},{"label":"Decision","prompt":"State what is being chosen and the scope of that commitment"},{"label":"Consequences","prompt":"List benefits, costs, risks, follow-up work, and compatibility impact"}]},{"heading":"Alternatives and evidence","guidance":"Show why the choice was reasonable without pretending uncertainty disappeared.","fields":[{"label":"Alternatives","prompt":"List viable options, including keeping the current state"},{"label":"Evaluation","prompt":"Compare options against explicit product, quality, safety, cost, and operating criteria"},{"label":"Evidence","prompt":"Link prototypes, benchmarks, evals, incidents, primary sources, and stakeholder input"}]},{"heading":"Review and supersession","guidance":"Define when new evidence requires the decision to be revisited.","fields":[{"label":"Review triggers","prompt":"Name thresholds, incidents, provider changes, scale, cost, or regulatory events"},{"label":"Review date","prompt":"Set a date when uncertainty or change rate makes scheduled review useful"},{"label":"Supersession","prompt":"Link the replacement decision and migration or cleanup work without rewriting history"}]}],"canonicalUrl":"https://agentatlas.dev/starter-kit/decision-log","downloadUrl":"https://agentatlas.dev/starter-kit/files/DECISIONS.md","sources":[{"label":"Building effective agents","publisher":"Anthropic","url":"https://www.anthropic.com/engineering/building-effective-agents","supports":"Composable workflow patterns, the workflow-versus-agent boundary, and the case for starting with simpler architecture."},{"label":"A2A protocol specification","publisher":"A2A Project","url":"https://a2a-protocol.org/latest/specification/","supports":"Architecture for communication between independently operated agents, including discovery, tasks, messages, artifacts, and security schemes."},{"label":"AGENTS.md specification","publisher":"AGENTS.md","url":"https://agents.md/","supports":"Versioned repository instructions that make build, test, style, and contribution requirements available to agents."},{"label":"GitHub Spec Kit","publisher":"GitHub","url":"https://github.github.com/spec-kit/index.html","supports":"Governed specification-driven workflows, quality checks, organizational principles, and traceability across delivery artifacts."},{"label":"Codex security","publisher":"OpenAI","url":"https://developers.openai.com/codex/security","supports":"Operational authority boundaries enforced through sandboxing, permissions, approvals, and network controls."},{"label":"GPT-5.4 model guide","publisher":"OpenAI","url":"https://developers.openai.com/api/docs/models/gpt-5.4","supports":"Current OpenAI model capabilities, context, tool support, controls, and operational characteristics."},{"label":"Claude prompting best practices","publisher":"Anthropic","url":"https://platform.claude.com/docs/en/build-with-claude/prompt-engineering/claude-prompting-best-practices","supports":"Current Claude prompting controls and provider-specific practices that should be evaluated rather than generalized across models."}]}],"downloads":{"bundle":"https://agentatlas.dev/starter-kit/files/production-agent-starter-kit.md","readme":"https://agentatlas.dev/starter-kit/files/README.md","integrityManifest":"https://agentatlas.dev/starter-kit/files/manifest.json"},"discovery":{"knowledgeCatalog":"https://agentatlas.dev/api/catalog/knowledge","topicsCatalog":"https://agentatlas.dev/api/catalog/topics","llms":"https://agentatlas.dev/llms.txt","feed":"https://agentatlas.dev/feed.json"}}