Spaces:
Sleeping
Sleeping
| ## What this folder is | |
| `.agent/` is the **operating system for AI agents** on this repo. It locks the architecture decisions from `../prd.md`, prevents scope creep under deadline pressure, and makes sure three engineers can use Cursor / Claude Code in parallel without drifting. | |
| If you're an agent: **load `project_context.md` first**. If you're a human: treat this folder like the team's constitution. | |
| ## Nonnegotiable rule (scope freeze) | |
| **Scope freeze is midnight Saturday (00:00 IST).** After that time: | |
| - Do not add features, endpoints, model changes, UI, or nice to haves. | |
| - Only do bug fixes, tests, wiring, docs, and reliability work that protects the locked deliverables. | |
| - If youre tempted to add something: append it to `FUTURE_WORK.md` and continue the locked task. | |
| ## Files and what each enforces | |
| - `project_context.md`: **Single source of truth**. The compressed PRD: what were building, why, who for, locked stack, 30sec pitch, nongoals. | |
| - `architecture.md`: **Technical contract**. File layout, dataclass schemas, XML action format, reward signature, observation schema, cheating prevention, required HTTP endpoints. | |
| - `coding_conventions.md`: **How we write code**. Typed dataclasses, import order, errors, forbidden patterns, repo hygiene. | |
| - `decision_log.md`: **Locked decisions + fallbacks**. PRD 7.1 in table form, PRD 7.2 fallback triggers. New decisions go here with timestamp+author. | |
| - `agent_instructions.md`: **System prompt** for any coding agent. Read order, refusal rules, time pressure behavior, fallback triggers. | |
| - `checkpoints.md`: **Team sync contract** at midnight / 9 AM / 3 PM. What must be demoable; what triggers scope cuts; what gets cut first. | |
| - `test_contracts.md`: **Blocking tests** required before merge: no-leak, reward cases, XML parser robustness, env smoke. | |
| - `git_workflow.md`: **Parallel work rules**. Branch naming, commit conventions, merge gates, no-force-push rules, pre-submission checklist. | |
| - `FUTURE_WORK.md`: **Parking lot** for anything not in current scope (pre-populated from PRD 14). | |
| ## Where the real spec lives | |
| The authoritative PRD is `../prd.md`. If any `.agent/` file disagrees with the PRD, **the PRD wins** and you must update the `.agent/` file immediately. | |
| ## Task files (per person) | |
| This repo expects per-person task lists: | |
| - `../tasks_niti.md` | |
| - `../tasks_deepak.md` | |
| - `../tasks_divyank.md` | |
| If they dont exist yet, create them now with 1020 bullet tasks each and keep them updated. Agents should read the relevant one **after** `project_context.md` and `architecture.md`. | |