Continuity runbook: Gap analysis ops
Nobody has claimed this yet.
- Dominant language
- Python
- Stars
- 180
- Forks
- 137
- Avg merge
- 3d 23h
- Merged PRs (30d)
- 21
Description
Task
A second maintainer can diagnose incomplete/503 map analysis on production and fix it by local backfill plus optional approved cache sync — never by computing gap analysis on Heroku.
Success criteria
- HTTP diagnose:
make monitor-ga-health-prod/make verify-ga-complete-prod - Can start local backfill:
make backfill-gap-analysisormake backfill-gap-analysis-syncafter local-stack - States clearly: prod is cache-only; miss → 404; no
--ga_backfill_*against prod URLs - Runbook
docs/continuity/runbooks/gap-analysis-ops.md(skillcontinuity-gap-analysis-ops)
Context
scripts/backfill_gap_analysis.sh,scripts/sync_gap_analysis_table.py- Worker dyno + Redis/Neo4j matter for 503s; restart may be the first prod action, still no GA compute on prod
Constraints
- existing maintainers only
- Do not sync GA tables to prod in the first drill unless asked
- No authenticated chatbot prompts as a “test”
Agent prompt
See Agent prompt in docs/continuity/runbooks/gap-analysis-ops.md.
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Start with docs/continuity/runbooks/gap-analysis-ops.md and its Agent prompt, then review scripts/backfill_gap_analysis.sh and scripts/sync_gap_analysis_table.py. Run the documented production health checks and local-stack backfill commands; done means the runbook covers diagnosis, local backfill, optional approved cache sync, cache-only production behavior, and the stated constraints.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- python, shell
- Domain
- devops, documentation
- Issue type
- Documentation
- Difficulty
- 4/5
- Estimated time
- 3-5 days
- Activity status
- Active
- Clarity
- Clearly specified
- Newbie friendliness
- 35/100