.agent/README.md

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.