feat: sync and reference Very Good Engineering content

Aberta
  • Algo errado?
#39 0 comentários 0 reações 0 responsáveis Ver no GitHub

Mantenedores costumam responder em até 1 dia

Ninguém assumiu esta issue ainda.

Avaliação

Dificuldade
4/5
Tempo estimado
3-5 dias
Facilidade para iniciantes
54/100
Tipo de issue
Funcionalidade
Clareza
Claramente especificada
Status de atividade
Ativa
Stack de tecnologia
dart, github, shell
Domínio
devtools, tooling

Direção de pesquisa

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.

Escrita pelo modelo de indexação a partir do texto da issue.

Descrição

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
Linguagem predominante
Dart
Estrelas
7
Forks
2
Merge médio
2d 8h
PRs com merge (30d)
9

Preparar o ambiente

Primeiros passos

  1. Leia a issue inteira e depois o guia de contribuição do projeto.
  2. Comente na issue dizendo que vai assumir — evita que duas pessoas façam o mesmo trabalho.
  3. Faça um fork do repositório e trabalhe em uma branch.
  4. Abra um pull request que referencie o número da issue.

Mais de VeryGoodOpenSource/vgv-ffca-plugin

Todas as issues de VeryGoodOpenSource/vgv-ffca-plugin

Issues semelhantes

Mais issues de Dart

Receba novas issues na sua caixa de entrada

Um resumo curto de issues do GitHub para quem está começando.