Skip to content

Index by Task

Use this index to find the right wiki section for a specific task you need to perform. It now covers all V1 and V2 sections.

I need to… Go to Notes
Debug a quota limit error retry-strategies.md See "Quota-level blocking" section; check logs/marketstack_quota_usage.json
Add a new data import source import-pipeline.md End-to-end import workflow, decision points, and validation checklist
Harden an alert or notification component error-handling.md Use the SMTP fail-open + explicit logging pattern
Investigate SMTP silent failures alert-system.md + log-rotation-runbook.md Follow failure triage first, then confirm retention and audit traces
Add tests for a new feature or bug fix testing-approach.md Test-first is mandatory for application behavior changes
Add a new external API integration security-checklist.md + retry-strategies.md Run the pre-commit checklist first; then apply retry pattern for the new API
Understand why a technical decision was made key-decisions.md Browse by decision name; each entry includes reversal conditions
Align dashboard decision logic with the investment strategy key-decisions.md + ../features/chapter4.md Use the July 2026 decision entry as the implementation baseline and Chapter 4 as business intent
Understand why the public demo mirrors secure dashboard cards key-decisions.md + ../activity_report/jul-26_dashboard-demo-parity.md Use the demo-parity decision entry for retained/removed cards and confidentiality constraints
Understand demo transaction and temporary holding deletion behavior key-decisions.md + 02_data-models/entity-map.md Deleting the last BUY after all SELL transactions are gone removes the holding temporarily; the next refresh restores the demo baseline
Fix inconsistent demo indicators (signs, overlaps, target coherence) key-decisions.md + ../activity_report/aug-26_demo-indicators-consistency-fix.md Use the August 2026 demo-coherence decision as the implementation and regression baseline (tc-demo14)
Fix mixed data-source leakage between analyst targets and 52-week thresholds key-decisions.md + ../activity_report/aug-26_52week-gauge-add-&-analyst_target-gauge-fix.md Follow the current separation rule: CSV analyst targets stay separate from the 52-week range, and missing values remain unavailable
Analyze valuation extremes (highest/lowest P/E and PEG) on dashboard key-decisions.md + ../activity_report/jul-26_add-pe&peg-valuation-indicators.md Use the P/E + PEG top/bottom decision entry as the reference behavior baseline
Understand the AI tooling strategy (Spec Kit vs LangChain) key-decisions.md See "Integrate LangChain as Analytical Complement" — covers boundary rules, phase 1 scope, and governance constraints
Understand the overall project architecture 01_architecture/index.md Section overview with links to all architecture documents
Review coding patterns used in this project 05_common-patterns/index.md Section overview with links to all 4 pattern files
Understand data ownership and persistence contracts entity-map.md + storage-contracts.md Start with entity map, then read storage-level contracts
Understand the GitHub Issue bridge flow github-issue-bridge.md Includes trigger path, payload shape, and audit files
Run AI code review before merge (local report mode) 03_workflows/index.md + deployment-and-ops-checklist.md Trigger /speckit.review, use terminal report as decision artifact, then post manual PR note if needed
Review a completed Copilot session and reduce token waste 03_workflows/session-review.md Trigger /speckit.session-review once at session closure; Chronicle uses compact aggregates and at most five relevant reports
Run deployment and operational checks deployment-and-ops-checklist.md Pre-deploy and post-deploy sequence
Understand why SC-009 was partial in V1 sc009-gap-analysis.md Root cause and V2 correction plan

Context

This index exists because common workflows (adding an import source, debugging quota errors, hardening alerts, and operating deployments) recur. Without a reference, each recurrence requires reverse-engineering the existing code. This index eliminates that overhead.

Details

Current scope: Entries now cover all 6 sections, including workflows, operations, and lessons learned. Updated 2026-06-25 to include the manual AI code review operating mode (terminal report as primary decision artifact).

For "add a new import source": This now points directly to 03_workflows/import-pipeline.md as the authoritative runbook, with pattern pages as supporting references.