Skip to content

Align Aesthetic Function description to ecosystem canon#1

Merged
ryandmonk merged 1 commit into
mainfrom
docs/canon-af-positioning
Jun 12, 2026
Merged

Align Aesthetic Function description to ecosystem canon#1
ryandmonk merged 1 commit into
mainfrom
docs/canon-af-positioning

Conversation

@ryandmonk

Copy link
Copy Markdown
Contributor

What this changes

Updates one paragraph in the README's "How it fits the ecosystem" section. The Aesthetic Function bullet previously read "the commercial product for the time dimension: detecting and reconciling drift between code and design surfaces continuously." It now reads "the open-core reconciliation engine beneath a commercial product: it reads a committed dspack file as a reference contract and continuously checks Figma, code, and docs against it."

The ecosystem ASCII diagram above it is unchanged.

Why

Part of a cross-repo positioning convergence (canon and full plan live in the private af-site repo; companion PRs: af-site#3, aesthetic-function#4). The old wording classified AF as simply "the commercial product," which conflicts with how the site, org profile, and aesthetic-function README now describe it: an open-core reconciliation engine beneath a commercial product, not a closed product. This brings the one sentence in this repo into line.

Checklist

  • npm test passes — N/A, documentation-only change (no code touched)
  • If output changed: fixtures regenerated — N/A, no generator output affected
  • Output remains deterministic (no new timestamps/unordered iteration) — no code changed
  • No new runtime dependencies
  • Within scope per CONTRIBUTING — README copy only; no diffing/watching/write-back/CI-gating
  • No repo-specific hacks

Golden diff explanation (if applicable)

None — no generator output changed.

🤖 Generated with Claude Code

The ecosystem-positioning sentence described AF as "the commercial
product for the time dimension," which conflicts with the canonical
open-core classification used across the other repos and the site.

Replace it with the canon wording: AF is the open-core reconciliation
engine beneath a commercial product, reading a committed dspack file as
a reference contract and continuously checking Figma, code, and docs
against it. The ecosystem diagram is unchanged.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Copilot AI review requested due to automatic review settings June 12, 2026 18:54

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR updates the README’s “How it fits the ecosystem” section to align the positioning of Aesthetic Function with the broader ecosystem canon (open-core reconciliation engine beneath a commercial product), without changing the surrounding ASCII diagram or any code/docs elsewhere.

Changes:

  • Rewrites the Aesthetic Function bullet to describe it as an open-core reconciliation engine that uses a committed dspack file as a reference contract and checks Figma/code/docs against it.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

@ryandmonk ryandmonk merged commit 4a0c49c into main Jun 12, 2026
1 check passed
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