Skip to content

docs: re-sync FFCA reference with VGV Engineering - #34

Open
Statyk7 wants to merge 1 commit into
mainfrom
docs/resync-ffca-reference
Open

Statyk7 wants to merge 1 commit into
mainfrom
docs/resync-ffca-reference

Conversation

@Statyk7

@Statyk7 Statyk7 commented Oct 21, 2026

Copy link
Copy Markdown
Collaborator

Description

Re-syncs references/ffca/ with dart run scripts/sync_reference.dart now that the VGV Engineering site has deployed two FFCA fixes raised while building the validator:

  • VGVentures/very_good_engineering#293: a shared package may depend on other shared packages. The mirrored Dependency rules table now matches the validator's shared → shared.
  • VGVentures/very_good_engineering#297: every page uses the lib/src/ layout; Layer subfolders states that packages import each other only through the barrels at the root of lib/, and that the data barrel exports the repository and data sources but never DTOs or mappers. data.md no longer says data sources are invisible outside the package.
  • faq.md picks up an unrelated upstream wording change.

No section heading changed, so every citation in the skills, the agent, and the code templates still resolves. Follow-ups in the same change:

  • ffca-architecture and ffca-cross-feature explained why a widget that needs a repository cannot live in ui_kit with the old rule ("shared packages depend on external packages only"). They now give the current one: shared packages never depend on feature packages.
  • The import checks in scripts/validate_layers.dart cite the new Layer subfolders sentences instead of noting the barrel rule was not stated yet. Comments only; no behavior change.

sync_reference.dart --check reports the mirror up to date, and mealify_feature_first still passes with no findings. Unblocks #23, the rules drift test.

Type of Change

  • New feature (feat)
  • Bug fix (fix)
  • Code refactor (refactor)
  • Documentation (docs)
  • CI change (ci)
  • Chore (chore)

🤖 Generated with Claude Code

https://claude.ai/code/session_017Vxxv9fVFGupLXEnmx5bSq

Brings in VGVentures/very_good_engineering#293 (shared packages may
depend on other shared packages) and #297 (lib/src/ layout on every
page, the data barrel exports data sources but never DTOs or mappers,
and packages import each other only through barrels), plus a wording
change in the FAQ.

The ffca-architecture and ffca-cross-feature skills now explain why a
widget that needs a repository cannot live in ui_kit with the current
rule: shared packages never depend on feature packages. The import
checks cite the barrel and data barrel rules in Layer subfolders, now
that the FFCA section states them.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_017Vxxv9fVFGupLXEnmx5bSq
@Statyk7
Statyk7 requested a review from a team as a code owner October 21, 2026 21:24
@Statyk7 Statyk7 self-assigned this Oct 21, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants