feat: sync and reference Very Good Engineering content

Offen
  • Stimmt etwas nicht?
#6 1 Kommentar 0 Reaktionen 0 zugewiesene Personen Auf GitHub ansehen

Maintainer antworten meist innerhalb von 1 Tag

Dieses Issue hat noch niemand übernommen.

Bewertung

Schwierigkeit
5/5
Geschätzter Aufwand
Über eine Woche
Anfängerfreundlichkeit
25/100
Issue-Typ
Feature
Klarheit
Größtenteils klar
Aktivitätsstatus
Aktiv
Tech-Stack
dart
Bereich
tooling

Rechercherichtung

First confirm that Very Good Engineering has published versioned, downloadable FFCA bundles. Then inspect hooks/hooks.json, scripts/sync_reference.dart, the skills, ffca-layer-auditor, and validate_layers.dart. Done means the hook syncs minor updates, holds major ones, fails open, and consumers fall back to references/ffca_architecture.md.

Vom Indexierungsmodell aus dem Issue-Text verfasst.

Beschreibung

external dependency feature

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

  • Add the sync script and wire it to SessionStart in hooks/hooks.json
  • Pin the VGE version this plugin was built against
  • Hold on a major difference, sync on a minor one
  • Fail open on any network or parse error
  • Point skills and ffca-layer-auditor at the cache, falling back to the bundled reference
  • Replace or remove the scripts/sync_reference.dart stub
  • Check whether validate_layers.dart rules need to follow the synced standard

Blocked

Waiting on Very Good Engineering to publish FFCA and to ship versioned, downloadable bundles. Nothing here is implementable until that lands.

Vorherrschende Sprache
Dart
Sterne
7
Forks
2
Ø Merge
2 T. 8 Std.
Gemergte PRs (30 T.)
9

Entwicklungsumgebung

Erste Schritte

  1. Lesen Sie das ganze Issue und danach den Beitragsleitfaden des Projekts.
  2. Schreiben Sie ins Issue, dass Sie es übernehmen — das erspart doppelte Arbeit.
  3. Forken Sie das Repository und arbeiten Sie in einem Branch.
  4. Öffnen Sie einen Pull Request, der die Issue-Nummer nennt.

Mehr aus VeryGoodOpenSource/vgv-ffca-plugin

Alle Issues in VeryGoodOpenSource/vgv-ffca-plugin

Ähnliche Issues

Weitere Issues zu Dart

Neue Issues direkt in Ihr Postfach

Eine kurze Übersicht über anfängerfreundliche GitHub-Issues.