docs(work): scaffold fallow-integration-v1 epic + stories

This commit is contained in:
2026-05-13 08:47:30 +02:00
parent 85fb050019
commit 2722305398
6 changed files with 179 additions and 3 deletions

View File

@@ -1,5 +1,5 @@
{
"updated_at": "2026-05-13T06:32:59.719Z",
"updated_at": "2026-05-13T06:47:32.677Z",
"epics": {
"agent-workflow-docs-v1": {
"status": "done",
@@ -202,6 +202,56 @@
}
}
},
"fallow-integration-v1": {
"status": "in-progress",
"title": "Fallow integration v1 — whole-codebase static analysis as 5th gate",
"stories": {
"01-fallow-install": {
"status": "in-progress",
"title": "Install fallow + create .fallowrc.json",
"ac_total": 4,
"ac_completed": 0,
"depends_on": [],
"blocks": [
"02-pnpm-turbo-wiring"
]
},
"02-pnpm-turbo-wiring": {
"status": "todo",
"title": "pnpm script + turbo task wiring",
"ac_total": 4,
"ac_completed": 0,
"depends_on": [
"01-fallow-install"
],
"blocks": [
"03-ci-integration"
]
},
"03-ci-integration": {
"status": "todo",
"title": "CI workflow runs pnpm fallow",
"ac_total": 2,
"ac_completed": 0,
"depends_on": [
"02-pnpm-turbo-wiring"
],
"blocks": [
"04-docs-and-prompts"
]
},
"04-docs-and-prompts": {
"status": "todo",
"title": "Docs + agent prompt updates",
"ac_total": 5,
"ac_completed": 0,
"depends_on": [
"03-ci-integration"
],
"blocks": []
}
}
},
"frontend-conformance-v1": {
"status": "done",
"title": "Frontend conformance rules v1",
@@ -359,6 +409,37 @@
}
}
},
"ready": [],
"blocked": []
"ready": [
{
"epic": "fallow-integration-v1",
"story": "01-fallow-install",
"title": "Install fallow + create .fallowrc.json"
}
],
"blocked": [
{
"epic": "fallow-integration-v1",
"story": "02-pnpm-turbo-wiring",
"title": "pnpm script + turbo task wiring",
"waiting_on": [
"fallow-integration-v1/01-fallow-install"
]
},
{
"epic": "fallow-integration-v1",
"story": "03-ci-integration",
"title": "CI workflow runs pnpm fallow",
"waiting_on": [
"fallow-integration-v1/02-pnpm-turbo-wiring"
]
},
{
"epic": "fallow-integration-v1",
"story": "04-docs-and-prompts",
"title": "Docs + agent prompt updates",
"waiting_on": [
"fallow-integration-v1/03-ci-integration"
]
}
]
}

View File

@@ -0,0 +1,17 @@
---
id: 01-fallow-install
epic: fallow-integration-v1
title: Install fallow + create .fallowrc.json
type: technical-story
status: in-progress
feature: tooling
depends-on: []
blocks: [02-pnpm-turbo-wiring]
---
## Tasks
- [ ] Story scaffold
- [ ] Add fallow to root devDependencies
- [ ] Create .fallowrc.json with monorepo-aware config
- [ ] Verify `pnpm exec fallow --version` works

View File

@@ -0,0 +1,17 @@
---
id: 02-pnpm-turbo-wiring
epic: fallow-integration-v1
title: pnpm script + turbo task wiring
type: technical-story
status: todo
feature: tooling
depends-on: [01-fallow-install]
blocks: [03-ci-integration]
---
## Tasks
- [ ] pnpm fallow script (runs all)
- [ ] pnpm fallow:audit script (runs `fallow audit --base main`)
- [ ] turbo.json task entry for fallow
- [ ] Run `pnpm fallow` against current repo, capture findings, tune config

View File

@@ -0,0 +1,15 @@
---
id: 03-ci-integration
epic: fallow-integration-v1
title: CI workflow runs pnpm fallow
type: technical-story
status: todo
feature: ci
depends-on: [02-pnpm-turbo-wiring]
blocks: [04-docs-and-prompts]
---
## Tasks
- [ ] Add `pnpm fallow` step after `pnpm conformance` in ci.yml
- [ ] Use --format annotations for inline GH PR comments

View File

@@ -0,0 +1,18 @@
---
id: 04-docs-and-prompts
epic: fallow-integration-v1
title: Docs + agent prompt updates
type: technical-story
status: todo
feature: agent-prompts
depends-on: [03-ci-integration]
blocks: []
---
## Tasks
- [ ] Update CLAUDE.md conformance-system section to list Fallow as 5th gate
- [ ] Update docs/guides/conformance-quickref.md with Fallow row
- [ ] Update .sandcastle/implementer.prompt.md: run `fallow audit` before commit
- [ ] Update .sandcastle/reviewer.prompt.md: verify implementer ran fallow audit
- [ ] Final verification + closeout

View File

@@ -0,0 +1,28 @@
---
id: fallow-integration-v1
prd: null
title: Fallow integration v1 — whole-codebase static analysis as 5th gate
type: epic
status: in-progress
features: [tooling, ci, agent-prompts]
created: 2026-05-13
---
## Goal
Wire Fallow as the 5th conformance gate: install, configure, pnpm script,
turbo task, CI step, docs update, agent prompt update.
## Why
Fallow catches what file-local lint, type-check, manifest assertions, and
conformance event closure cannot — dead code, dupes, circular deps,
complexity hotspots, and AI-change drift. `fallow audit --base main` is
purpose-built for AI agents to self-validate before submission.
## Stories
- [ ] [01 — Install fallow + .fallowrc.json](01-fallow-install/_story.md)
- [ ] [02 — pnpm + turbo wiring](02-pnpm-turbo-wiring/_story.md)
- [ ] [03 — CI workflow integration](03-ci-integration/_story.md)
- [ ] [04 — Docs + agent prompt updates](04-docs-and-prompts/_story.md)