feat: sync and reference Very Good Engineering standards

Aperta
  • Qualcosa non va?
#269 0 commenti 0 reazioni 0 assegnatari Vedi su GitHub

I maintainer di solito rispondono entro 6 giorni

Nessuno ha ancora preso questa issue.

Valutazione

Difficoltà
4/5
Tempo stimato
3-5 giorni
Idoneità per principianti
48/100
Tipo di issue
Funzionalità
Chiarezza
Abbastanza chiara
Stato di attività
Attiva
Stack tecnologico
bash, github-actions, shell
Ambito
developer-experience, tooling

Direzione di ricerca

Start with the companion plugin’s sync script and hooks in VeryGoodOpenSource/vgv-ai-flutter-plugin#185 and #186; this issue names the target directories and files but not their paths in Wingspan. Trace how SessionStart and SubagentStart hooks are configured, then inspect the existing shared cache lock. Done means standards sync, cache handoff, agent pointers, fail-open behavior, and CI tests meet the listed requirements; the issue proposes splitting this across two PRs.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Descrizione

feature p2
Description

Port the VGE standards sync from vgv-ai-flutter-plugin (VeryGoodOpenSource/vgv-ai-flutter-plugin#185, #186). Wingspan currently points at engineering.verygood.ventures by URL or restates standards from memory: AGENTS.md, agents/codebase-review/codebase-review-agent.md, skills/shared/references/plan-review.md, and the review agents checking against "VGV engineering standards". Those copies drift whenever VGE changes.

Wingspan is tech-agnostic, so it references only the stack-neutral sections. Flutter-specific sections stay with the companion plugin.

  • general-practices/: philosophy.md, code_review.md, conventions.md
  • architecture/architecture.md
Requirements
  • SessionStart hook runs sync-vge-standards.sh, ported from the Flutter plugin
  • Uses the shared cache in ${XDG_CACHE_HOME:-~/.cache}/very_good_engineering/bundles/, coexisting with other VGV plugins via the existing lock
  • Pins VGE_TARGET_MAJOR and pauses the sync when a newer major is published
  • Fails open on any network, parse or filesystem error
  • SubagentStart hook hands the cache path to the review agents
  • Skills and review agents read the cached sections instead of restating standards, falling back to the published URL
  • Sync script tests run in CI
Additional Context

Split like the Flutter plugin: one PR for the sync hook, one for skill and agent pointers.

Lingua principale
Shell
Stelle
114
Fork
16
Merge medio
6g 1h
PR unite (30g)
10

Preparare l'ambiente

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Altre issue di VeryGoodOpenSource/vgv-wingspan

Tutte le issue di VeryGoodOpenSource/vgv-wingspan

Issue simili

Altre issue su Shell/Bash

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.