agentic-sdlc-blog

AGENTS.txt

# AGENTS.md

## 📋 Project Summary
- **Domain:** [Describe your project focus, e.g., Membership Management / Core CRM Portal]
- **Target Environment:** Local dev sandbox and containerized staging pipelines.

## ⚙️ Tech Stack & Constraints
- **Core Architecture:** [List core design patterns or framework setups]
- **Frontend/UI:** [List UI engine or styling systems, e.g., Vue.js / Tailwind]
- **Backend/Data Layer:** [List backend engine or state wrappers, e.g., Laravel / SQL]

## 🔀 Must-Follow Git Rules
1. **Branch Naming:** Follow `feature/[ticket-id]-short-description` or `bugfix/[ticket-id]-short-description`. Never commit directly to main.
2. **Incremental Commits:** Make small, atomic, logical commits as individual sub-tasks pass verification.
3. **Commit Messages:** Strictly follow the Conventional Commits specification (e.g., `feat(auth): add login validation layout`).
4. **Pull Requests:** Every PR must provide a structured markdown description, link directly to the originating issue ID, and provide an explicit checklist of modifications.

WIP.txt

# WIP: Feature - [Feature Name/Ticket ID] (Agent Scratchpad)

## 🎯 Current Objective
- [State the current micro-task the agent is actively processing]

## 🏁 Task Checklist
- [x] Completed milestone sub-task
- [/] Active sub-task currently in progress <!-- LOGICAL EXECUTION LOOP IS HERE -->
- [ ] Upcoming task awaiting execution state
- [ ] Integration validation testing gate

## 🚨 Active Run State & Blockers
- **Current Internal State:** [e.g., The local compile is failing due to an implicit type mismatch on interceptor headers]
- **Next Tactical Pivot:** [e.g., Injecting explicit error tracking boundaries inside the wrapper engine before re-running the local validation script]

workflow.txt

.devin/workflows/
├── 01-parse-ticket.md        # Extracts issue criteria, acceptance parameters, and task dependencies
├── 02-setup-branch.md        # Syncs local tracking branches and cuts a standardized feature branch
├── 03-execution-state.md     # Spreads tasks into atomic milestones and spins up the tracking scratchpad
├── 04-validation-build.md    # Compiles project locally, running lints and test suites before pushing
└── 05-pull-request.md        # Assembles the formal, structured pull request template back to GitHub