stayfresh
field notes // workflows // research

instant project sync

objective: instantaneous project management by synchronizing ticket queues against agentic file search of consulting documentation and contract dates.

when documentation is missing, requirements are decomposed from code, user tickets, and available manuals.

why this workflow exists

project drift frequently comes from evidence mismatch: ticket claims, contract obligations, and real implementation state diverge.

this loop closes that gap by requiring every active ticket to map to source evidence and date-bound obligations.

core inputs

execution loop (daily)

1. ingest open tickets
2. run agentic file search for each ticket:
   - matching requirement text
   - matching contract clause or milestone
   - matching code path or manual section
3. score evidence confidence (high/medium/low)
4. detect date conflicts:
   - ticket due > contract milestone
   - missing owner for date-critical work
   - unresolved dependency blocking contracted delivery
5. produce sync board:
   - now: must ship in current window
   - next: scheduled and contract-aligned
   - risk: misaligned, under-specified, or date-broken
6. open remediation tickets automatically for all risk items

no-documentation fallback

if formal documentation is absent, the workflow does not stop.

requirements are reconstructed from implementation and user intent:

1. extract feature surfaces from code:
   rg -n "TODO|FIXME|feature|flag|endpoint|workflow" .
2. parse user tickets for expected outcomes and acceptance hints
3. mine manuals/help docs for promised behavior
4. infer provisional requirements:
   - actor
   - action
   - expected result
   - failure boundary
5. mark each inferred requirement as provisional until reviewed
6. attach inferred requirement ids back to tickets

contract date reconciliation rules

minimal data contract

{
  "ticket_id": "J-142",
  "requirement_ref": "REQ-09",
  "contract_ref": "SOW-2.4",
  "contract_date": "2026-04-15",
  "evidence_paths": ["src/billing/renewal.ts", "manuals/billing.md"],
  "confidence": "medium",
  "status": "risk",
  "owner": "pm@company"
}

output artifacts

fast start prompt

Synchronize open tickets against repository evidence and contract dates.
For each ticket:
- map requirement_ref and contract_ref
- extract evidence paths
- classify confidence
- flag date conflicts
If documentation is missing, infer provisional requirements from code, user tickets, and manuals.
Return now/next/risk board plus remediation tickets.

bottom line

this workflow treats project management as a synchronization problem rather than a dashboard problem.

evidence-linked tickets plus contract-date reconciliation support predictable delivery.

delivery tickets sync