scriptoriumadmin/fabro
1
0
Fork 0
mirror of https://github.com/fabro-sh/fabro.git synced 2026-08-28 05:27:41 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 4
fabro/docs/internal
History
Bryan Helmkamp 08cd80cac7
docs: add React effects policy (#419) 
## Summary

Adds an internal React effects policy for `apps/fabro-web` so direct
component effects are exceptional and real external integrations move
behind purpose-named hooks.

The policy covers preferred alternatives such as render-time derivation,
SWR query hooks, mutation callbacks, URL/router primitives, keyed
resets, and `useSyncExternalStore`. It also documents guardrails for
`useMountEffect`, React 19 `useEffectEvent`, one-shot telemetry effects,
migration workflow, current hotspots, and review checklist.

## Verification

Not run; docs-only change.

---

[![Compound
Engineering](https://img.shields.io/badge/Compound_Engineering-6366f1)](https://github.com/EveryInc/compound-engineering-plugin)
🤖 Generated with GPT-5 via [Codex](https://openai.com/codex)
2026-05-26 19:30:02 -04:00
..
assets/brand docs: move published docs under docs/public 2026-04-26 21:19:46 -04:00
demo chore(demo): move simplify prompt to prompts/ alongside graphs 2026-04-30 08:35:48 -04:00
licenses docs: move published docs under docs/public 2026-04-26 21:19:46 -04:00
product refactor(workflow): remove retro stage (#230) 2026-05-09 10:18:20 -04:00
cargo-target-apfs-churn-plan.md docs: commit plan 2026-04-28 09:46:52 -07:00
cli-workflow-coupling-audit.md refactor(types): remove stage status compatibility 2026-04-30 06:48:47 -04:00
error-handling-strategy.md docs: clarify chain-rendering boundary in error strategy 2026-05-04 11:28:28 -04:00
event-schema-competitive-analysis.md docs: move published docs under docs/public 2026-04-26 21:19:46 -04:00
events-strategy.md refactor(workflow): remove retro stage (#230) 2026-05-09 10:18:20 -04:00
events.md Add agent context observability events (memory, skills, MCP tools) (#356) 2026-05-22 19:06:00 -04:00
fabro-event-schema-v2-concrete-shape.md Add ACP backend support (#237) 2026-05-11 23:39:43 -04:00
fabro-event-schema-v2-proposal.md docs: move published docs under docs/public 2026-04-26 21:19:46 -04:00
llm-client-resolution.md docs(llm): finish configurable provider cleanup (#260) 2026-05-13 17:17:54 -04:00
logging-strategy.md feat(cli): polish foreground TTY logs 2026-05-06 15:31:25 -04:00
mcp-server-qa-test-plan.md Replace queued with pending/runnable and add approval flow (web + API s… (#371) 2026-05-23 15:34:33 -04:00
migrations-strategy.md refactor: rationalize server secret scopes (vault-only for optional int… (#401) 2026-05-25 17:26:01 -04:00
plan-events-as-source-of-truth-follow-ups.md refactor(run-projection): use stage vocabulary 2026-05-01 19:56:22 -04:00
plan-events-as-source-of-truth.md Make git metadata sandbox-native 2026-04-27 21:43:15 -07:00
react-effects-policy.md docs: add React effects policy (#419) 2026-05-26 19:30:02 -04:00
run-directory-keys.md refactor(workflow): remove retro stage (#230) 2026-05-09 10:18:20 -04:00
server-secrets-strategy.md refactor: rationalize server secret scopes (vault-only for optional int… (#401) 2026-05-25 17:26:01 -04:00
slow-test-opportunities-2026-04-07.md docs: move published docs under docs/public 2026-04-26 21:19:46 -04:00
testing-strategy.md docs: move published docs under docs/public 2026-04-26 21:19:46 -04:00
updating-web-screenshots.md refactor(workflow): remove retro stage (#230) 2026-05-09 10:18:20 -04:00