Skip to content

docs: Linear integration specs (6 directions, 4 specs) #75

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
Wescome wants to merge 1 commit into
base: main
Choose a base branch
from
Open

docs: Linear integration specs (6 directions, 4 specs) #75

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
28 changes: 28 additions & 0 deletions docs/linear-integration/README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,28 @@
# Linear Integration — Specification Index

Six directions for integrating Linear as a governance surface for the
Function Factory. Directions 1, 3, and 6 collapse into `SPEC-LINEAR-SYNC-SERVICE-001`;
the remaining three have dedicated specs.

| Direction | Description | Spec |
|-----------|-------------|------|
| 1 | WorkGraph atoms as Linear issues (P1/P2 atom + trace state projections) | SPEC-LINEAR-SYNC-SERVICE-001 |
| 2 | Linear as We-layer Disposition Event surface (ff-linear-bridge) | SPEC-FF-LINEAR-BRIDGE-001 |
| 3 | Divergence → Linear issue with A9 elucidation (P3 divergence projection) | SPEC-LINEAR-SYNC-SERVICE-001 |
| 4 | Linear cycle as governance sprint cadence (CycleAwarenessService) | SPEC-FF-CYCLE-HEALTH-001 |
| 5 | Factory commit tracing via FACTORY_* env vars → git trailers → SHA back to Linear | SPEC-FF-COMMIT-TRACING-001 |
| 6 | Factory Health as living Linear document (P4 health document) | SPEC-FF-CYCLE-HEALTH-001 |

## Key architectural finding

Linear is already the We-layer during Bootstrap. The bridge is a
translation layer; the WeOps Console (SPEC-WEOPS-CONSOLE-001) is the
native surface. The `WEOPS_SIGNING_KEY` is shared between the bridge and
the Console — no gateway update required during Phase 1→3 migration.

## Implementation order

1. `SPEC-LINEAR-SYNC-SERVICE-001` — P1 atom projection (unblocks WEO-7/8/9)
2. `SPEC-FF-LINEAR-BRIDGE-001` — bridge webhook handler (unblocks human Dispositions)
3. `SPEC-FF-COMMIT-TRACING-001` — commit tracing (closes lineage loop)
4. `SPEC-FF-CYCLE-HEALTH-001` — cycle cadence + health document (observability)
Loading
Loading