# Agentic Coding

> Use agent-operated evidence and developer judgment to plan, build, verify, and review production software.

Use the foundation when a repository needs a dependable starting point. Use the refinement prompt when valuable project-specific instructions already exist. The cookbook contains focused workflows for planning, execution, investigation, and review.

## Core resources

- [Project overview](https://agenticcoding.jesusgraterol.dev/): The principles, operating model, maturity loop, and practical resources behind Agentic Coding.
- [AGENTS.md foundation](https://agenticcoding.jesusgraterol.dev/AGENTS.md): The canonical Markdown template for establishing production-quality coding-agent instructions.
- [Instruction refinement prompt](https://agenticcoding.jesusgraterol.dev/refine.txt): A preservation-first prompt for strengthening an existing instruction system.
- [Cookbook index](https://agenticcoding.jesusgraterol.dev/cookbook/): The complete collection of practical Agentic Coding workflows.

## Cookbook recipes

- [Orient to a codebase](https://agenticcoding.jesusgraterol.dev/cookbook/orient-to-a-codebase/): Build a verified working map of an unfamiliar repository before asking the agent to change it.
- [Plan a feature](https://agenticcoding.jesusgraterol.dev/cookbook/plan-a-feature/): Turn a desired outcome into a codebase-grounded implementation strategy with an explicit approval boundary.
- [Challenge a plan](https://agenticcoding.jesusgraterol.dev/cookbook/challenge-a-plan/): Attack a proposed strategy before implementation makes false assumptions and weak boundaries expensive.
- [Break down a plan](https://agenticcoding.jesusgraterol.dev/cookbook/break-down-a-plan/): Convert an approved strategy into outcome-based milestones that remain coherent, testable, and reviewable.
- [Execute one milestone](https://agenticcoding.jesusgraterol.dev/cookbook/execute-one-milestone/): Authorize one complete implementation slice, then hand it to agent-operated evidence and developer judgment.
- [Control scope](https://agenticcoding.jesusgraterol.dev/cookbook/control-scope/): Give the agent enough context to understand the full path without authorizing every dependency it discovers.
- [Synchronize documentation](https://agenticcoding.jesusgraterol.dev/cookbook/synchronize-documentation/): Update durable documentation from the implemented behavior without turning the task into a documentation rewrite.
- [Recover from agent drift](https://agenticcoding.jesusgraterol.dev/cookbook/recover-from-agent-drift/): Stop a wandering implementation, preserve useful work, and re-establish a trustworthy task contract.
- [Investigate a failing test](https://agenticcoding.jesusgraterol.dev/cookbook/investigate-a-failing-test/): Establish intended behavior before changing production code, expectations, fixtures, or snapshots.
- [Deepen a test strategy](https://agenticcoding.jesusgraterol.dev/cookbook/deepen-a-test-strategy/): Design tests around realistic defects and integration boundaries instead of chasing test count or coverage.
- [Review a change](https://agenticcoding.jesusgraterol.dev/cookbook/review-a-change/): Have the agent assemble adversarial evidence for the developer's acceptance decision.
- [Refine coding instructions](https://agenticcoding.jesusgraterol.dev/cookbook/refine-coding-instructions/): Strengthen an existing instruction system without erasing repository knowledge or granting silent authority.

## Optional

- [Source repository](https://github.com/jesusgraterol/agenticcoding): Source code, content, and issue tracker for this website.
- [Author](https://jesusgraterol.dev/): More work by Jesus Graterol.
- [Moldea](https://moldea.ai/): The project work through which these principles were developed and tested.