ప్రధాన కంటెంట్‌కి దాటవేయండి

దీర్ఘకాలిక ఏజెంట్ వర్క్‌ఫ్లో

ఒక పని బహుళ సెషన్‌లు, హ్యాండ్‌ఆఫ్‌లు లేదా స్పాన్డ్ ఏజెంట్‌లను విస్తరించే అవకాశం ఉన్నప్పుడు ఈ ప్లేబుక్‌ని ఉపయోగించండి.

లక్ష్యాలు​

  • ప్రతి తాజా సెషన్‌కు సందర్భాన్ని తిరిగి పొందడానికి వేగవంతమైన మార్గాన్ని అందించండి
  • పెద్ద మార్పును ఒక్కసారిగా కొట్టే బదులు పనిని పెంచుకోండి
  • మరింత కోడ్‌ని జోడించే ముందు విరిగిన స్థానిక బేస్‌లైన్‌ను క్యాచ్ చేయండి
  • తదుపరి సెషన్ విశ్వసించగల మన్నికైన కళాఖండాలను వదిలివేయండి

రాష్ట్రాన్ని ఎక్కడ ఉంచాలి​

  • మానవులు, సమీక్ష బాట్‌లు లేదా బహుళ టూల్‌చెయిన్‌లకు ఒకే పని స్థితి అవసరమైనప్పుడు docs/agent-runs/<slug>/ని ఉపయోగించండి.
  • టాస్క్ స్టేట్ ఉద్దేశపూర్వకంగా ఒక వర్క్‌స్టేషన్ లేదా ఒక టూల్‌చెయిన్‌కు స్థానికంగా ఉన్నప్పుడు మాత్రమే .codex/runs/<slug>/ వంటి సాధనం-స్థానిక డైరెక్టరీని ఉపయోగించండి.
  • మరొక కంట్రిబ్యూటర్ లేదా ఏజెంట్‌కి తర్వాత అవసరమైతే బహుళ-సెషన్ భాగస్వామ్య స్థితిని ప్రైవేట్ స్క్రాచ్ ఫైల్‌లో దాచవద్దు.

అవసరమైన ఫైల్‌లు​

దీర్ఘకాలంగా కొనసాగుతున్న పని ప్రారంభంలో ఈ ఫైల్‌లను సృష్టించండి:

  • feature-list.json
  • progress.md

docs/agent-playbooks/templates/feature-list.template.json మరియు docs/agent-playbooks/templates/progress.template.mdలో టెంప్లేట్‌లను ఉపయోగించండి.

ఫీచర్ జాబితా కోసం JSONకు ప్రాధాన్యత ఇవ్వండి, తద్వారా ఏజెంట్లు మొత్తం పత్రాన్ని తిరిగి వ్రాయకుండానే తక్కువ సంఖ్యలో ఫీల్డ్‌లను నవీకరించగలరు.

సెషన్ ప్రారంభ చెక్‌లిస్ట్​

  1. pwdని అమలు చేయండి.
  2. progress.md చదవండి.
  3. feature-list.json చదవండి.
  4. git log --oneline -20ని అమలు చేయండి.
  5. ./scripts/agent-init.sh --smokeని అమలు చేయండి.
  6. ఇప్పటికీ pending, in_progress, లేదా blocked వంటి అత్యధిక ప్రాధాన్యత కలిగిన ఒక అంశాన్ని ఎంచుకోండి.

స్మోక్ స్టెప్ విఫలమైతే, కొత్త ఫీచర్ స్లైస్‌ని అమలు చేయడానికి ముందు విరిగిన బేస్‌లైన్‌ను పరిష్కరించండి.

సెషన్ నియమాలు​

  • ఒక సమయంలో ఒక ఫీచర్ లేదా టాస్క్ స్లైస్‌పై పని చేయండి.
  • ఫీచర్ జాబితాను మెషిన్-రీడబుల్ మరియు స్థిరంగా ఉంచండి. సంబంధం లేని అంశాలను తిరిగి వ్రాయడానికి బదులుగా స్థితి, గమనికలు, ఫైల్‌లు మరియు ధృవీకరణ ఫీల్డ్‌లను నవీకరించండి.
  • ఆ ఐటెమ్‌లో జాబితా చేయబడిన కమాండ్ లేదా యూజర్ ఫ్లోను అమలు చేసిన తర్వాత మాత్రమే ధృవీకరించబడిన అంశాన్ని గుర్తించండి.
  • మొత్తం టాస్క్-స్టేట్ యాజమాన్యం కోసం కాకుండా బౌండ్డ్ స్లైస్‌ల కోసం స్పాన్డ్ ఏజెంట్‌లను ఉపయోగించండి.
  • చైల్డ్ ఏజెంట్ ఒక వస్తువును కలిగి ఉన్నప్పుడు, దానికి ఖచ్చితమైన ఐటెమ్ ఐడి, అంగీకార ప్రమాణాలు మరియు అది తాకగల ఫైల్‌లను ఇవ్వండి.

సెషన్ ముగింపు చెక్‌లిస్ట్​

  1. progress.mdకి చిన్న ప్రోగ్రెస్ ఎంట్రీని జత చేయండి.
  2. feature-list.jsonలో తాకిన అంశాన్ని నవీకరించండి.
  3. ధృవీకరణ కోసం అమలు చేయబడిన ఖచ్చితమైన ఆదేశాలను రికార్డ్ చేయండి.
  4. క్యాప్చర్ బ్లాకర్స్, ఫాలో-అప్‌లు మరియు రెస్యూమ్ చేయడానికి తదుపరి ఉత్తమ వస్తువు.

సిఫార్సు చేసిన ప్రోగ్రెస్ ఎంట్రీ షేప్​

వంటి చిన్న నిర్మాణాన్ని ఉపయోగించండి:

## 2026-03-17 14:30

- Item: F003
- Summary: Updated the browser-check flow to use the shared init/bootstrap path.
- Files: `.cursor/agents/browser-check.md`, `.codex/agents/browser-check.toml`
- Verification: `corepack yarn build`, `corepack yarn lint`, `corepack yarn typecheck`
- Next: Run the smoke flow and update the task-board status.