What
Pull the latest published FFCA standard from Very Good Engineering at session start, and have skills and the auditor read that cache instead of the bundled copy in references/ffca_architecture.md.
Why
references/ffca_architecture.md is a hand-maintained mirror of the FFCA page, and scripts/sync_reference.dart is still a stub. Every change to the standard needs a manual edit plus a plugin release, and plugins are not updated reliably on local machines. The mirror drifts as soon as the source changes. Same approach as VeryGoodOpenSource/vgv-ai-flutter-plugin#158.
How
- A
SessionStart hook runs a sync script before any work begins.
- The script compares the locally cached VGE version against the published one.
- Minor difference: download and overwrite the cache.
- Major difference: keep the cached copy and wait for a plugin release, since renamed or new sections may need skills rewired. Skills cite sections by name, such as Dependency Graph Rules and Naming Conventions (Enforced).
- The cache lives outside the plugin directory so it survives reinstalls.
- The bundled
references/ffca_architecture.md stays as the fallback when no cache exists.
Sync must fail open. A network failure, a slow response, or an offline machine cannot block the session or the hook's time budget.
Sections
FFCA architecture. Layered Architecture too, since the skills defer to it for non-FFCA repos.
Tasks
Blocked
Waiting on Very Good Engineering to publish FFCA and to ship versioned, downloadable bundles. Nothing here is implementable until that lands.
What
Pull the latest published FFCA standard from Very Good Engineering at session start, and have skills and the auditor read that cache instead of the bundled copy in
references/ffca_architecture.md.Why
references/ffca_architecture.mdis a hand-maintained mirror of the FFCA page, andscripts/sync_reference.dartis still a stub. Every change to the standard needs a manual edit plus a plugin release, and plugins are not updated reliably on local machines. The mirror drifts as soon as the source changes. Same approach as VeryGoodOpenSource/vgv-ai-flutter-plugin#158.How
SessionStarthook runs a sync script before any work begins.references/ffca_architecture.mdstays as the fallback when no cache exists.Sync must fail open. A network failure, a slow response, or an offline machine cannot block the session or the hook's time budget.
Sections
FFCA architecture. Layered Architecture too, since the skills defer to it for non-FFCA repos.
Tasks
SessionStartinhooks/hooks.jsonffca-layer-auditorat the cache, falling back to the bundled referencescripts/sync_reference.dartstubvalidate_layers.dartrules need to follow the synced standardBlocked
Waiting on Very Good Engineering to publish FFCA and to ship versioned, downloadable bundles. Nothing here is implementable until that lands.