System Scope — Technical Appendix (Canonical)
Internal-only technical reference. Source-of-truth for implementation and future API / schema design.
System scope
Observed surfaces and continuity signals across connected tools.
Signals captured
- Message events: create/edit/delete, reactions, mentions, threads, reply chains
- Decision language cues: commitments, approvals, reversals, blockers, ownership statements
- Intent/priority cues: urgency markers, deadlines, "next step" statements
- Context cues: links, attachments, referenced artifacts, quoted text, forward references
- Temporal cues: when a decision was made vs when work occurred elsewhere
Artifacts tracked
- Tickets/issues: state transitions, assignee changes, priority changes, comments
- PRs/commits: references to tickets, reviewers, approvals, merge state, reverted work
- Docs/pages: edits, comments, headings referenced in discussions
- Deploy/releases: version markers, environments, timestamps, rollback signals
- Incidents/alerts: creation, escalation, resolution notes, postmortems
Dependencies
- Cross-tool entity resolution (same "thing" represented in multiple systems)
- Link extraction and normalization (ticket ↔ PR ↔ doc ↔ message)
- Relationship types:
- "supports / depends on"
- "supersedes / replaces"
- "blocked by / waiting on"
- "decided in / implemented in"
- Confidence scoring for inferred links vs explicit links
- Drift detection in the graph (links that go stale, missing edges, conflicting edges)
Continuity and drift detection
- Dropped-thread detection: decision exists with no downstream execution artifact
- Orphan work detection: execution exists with no upstream decision trail
- Context decay: key rationale present in chat but absent in ticket/doc
- Decision drift: original intent conflicts with later actions or ticket changes
- Ownership drift: implicit owner vs actual assignee divergence
- Scope creep signals: expanding requirements without corresponding decision update
- Repeat-loop signals: recurring questions that indicate missing canonical context
Agreement preservation
- Canonical "what we agreed" extraction (short, source-linked)
- Change-of-mind detection (explicit reversals, re-litigation)
- Conflict surfaces: two simultaneous "truths" across tools, competing priorities without resolution
- Timestamped agreement snapshots (what was true at time T)
Outputs and delivery
- Digest outputs (quiet, periodic): unresolved drift, orphan work, missing rationale
- Event-driven outputs (sparse): a decision is at risk, a dependency edge broke, a thread dropped
- Per-surface views (optional later): "Decision trail" for a ticket/PR without building a dashboard
- Deep links back to source-of-truth artifacts (no re-hosting content)
- Alert semantics:
- "Needs linking" (missing edges)
- "Decision not implemented" (agreement with no execution)
- "Work not justified" (execution with no decision trail)
- "Conflicting truth" (tool states disagree)
- "Rationale missing" (implementation changed without updated decision context)
- Noise controls: rate limits, collapse duplicates, confidence thresholds, user-level suppression rules
Integrations surface (initial + expandable)
- Chat: Slack / Teams-style message graphs (channels, threads, mentions)
- Work tracking: Jira / Linear-style issues and state changes
- Code: GitHub/GitLab-style PR/commit references and approvals
- Docs: Notion/Confluence-style pages and edits
- Alerts/ops: incident and monitoring event streams
- Identity: user mapping across tools (email/SCIM where available)
Identity and access
- Actor resolution across systems (same person, multiple accounts)
- Workspace/project boundaries respected (no cross-boundary inference)
- Role-aware visibility (only show what the viewer can already access in-source)
Constraints and non-goals
- No new workflow requirement
- No attention-seeking dashboard by default
- No "engagement" mechanics, no activity scoring for its own sake
- No selling or sharing user data; no surveillance monetization
- Data minimization: store only what is required to preserve continuity and link trails
- Explainability: every surfaced claim links back to source events/artifacts
Future depth (kept terse)
- Custom policies: define what counts as a "decision," "done," "drift"
- Team-specific ontology: map labels/states to meaning
- Org-wide dependency atlas (opt-in, permissioned)
Scope evolves; principles stay fixed.