feat: sync and reference Very Good Engineering content

Ouverte
  • Quelque chose ne va pas ?
#39 0 commentaires 0 réactions 0 personnes assignées Voir sur GitHub

Les mainteneurs répondent en général sous 1 jour

Personne n'a encore pris cette issue.

Évaluation

Difficulté
4/5
Temps estimé
3-5 jours
Accessibilité débutants
54/100
Type d'issue
Fonctionnalité
Clarté
Clairement spécifiée
Activité
Active
Stack technique
dart, github, shell
Domaine
devtools, tooling

Piste de recherche

Read the existing hooks, skills, and ffca-layer-auditor instructions, then compare the referenced Flutter plugin implementation and bundle index at https://engineering.verygood.ventures/bundles/1/index.json. Implement the session sync and subagent path handoff, update the listed documentation, and add sync-vge-standards_test.sh under Hook Tests. Done means synced FFCA files are used when available, local references are the fallback, and failures leave the session usable.

Rédigé par le modèle d'indexation à partir du texte de l'issue.

Description

feature
Description

Sync the published Very Good Engineering standards at session start and have skills and the auditor read them, the same way very_good_ai_flutter_plugin does in VeryGoodOpenSource/very_good_ai_flutter_plugin#185 and VeryGoodOpenSource/very_good_ai_flutter_plugin#186.

references/ffca/ already mirrors the FFCA pages, but only at release time. Plugins are not updated reliably on local machines, so a VGE edit reaches users only after a release and a reinstall. All seven FFCA pages are published in the VGE bundles under architecture/ffca/.

  • Add a SessionStart hook, sync-vge-standards.sh, that writes to the shared ${XDG_CACHE_HOME:-~/.cache}/very_good_engineering/bundles/ cache, so a session that also has the Flutter plugin installed downloads nothing twice.
  • Pin the targeted major with VGE_TARGET_MAJOR and pause the sync on a newer major.
  • Add a SubagentStart hook that hands ffca-layer-auditor the synced path.
  • Point skills at the synced FFCA files, falling back to references/ffca/ when there is no synced copy.
  • Fail open on any network, parse, or filesystem error.
Requirements
  • All CI/CD checks are passing.
  • There is no drop in the test coverage percentage.
  • sync-vge-standards_test.sh covers the hook and runs under Hook Tests.
  • Every skill and ffca-layer-auditor reads the synced FFCA files and falls back to references/ffca/.
  • README.md Hooks, CLAUDE.md ## Hooks, and AGENTS.md are updated.
Additional Context
Langage dominant
Dart
Étoiles
7
Forks
2
Merge moyen
2 j 8 h
PR mergées (30 j)
9

Préparer son environnement

Par où commencer

  1. Lisez l'issue en entier, puis le guide de contribution du projet.
  2. Signalez en commentaire que vous la prenez — cela évite que deux personnes fassent le même travail.
  3. Forkez le dépôt et travaillez sur une branche.
  4. Ouvrez une pull request qui référence le numéro de l'issue.

Autres issues de VeryGoodOpenSource/vgv-ffca-plugin

Toutes les issues de VeryGoodOpenSource/vgv-ffca-plugin

Issues similaires

Plus d'issues Dart

Recevez les nouvelles issues par e-mail

Un résumé court des issues GitHub adaptées aux débutants.