Skip to content

docs: replace PRODUCT.md with CONTEXT.md, remove vendor-strategy framing#53

Merged
chaksaray merged 1 commit into
developfrom
docs-context-replaces-product
Jul 17, 2026
Merged

docs: replace PRODUCT.md with CONTEXT.md, remove vendor-strategy framing#53
chaksaray merged 1 commit into
developfrom
docs-context-replaces-product

Conversation

@chaksaray

Copy link
Copy Markdown
Contributor

Summary

PRODUCT.md asserted AVE is "Layer 1 of the Bawbel five-layer architecture" whose open layers "drive adoption" for a "commercial moat," and carried a full adoption-strategy/roadmap section (Product Hunt targets, launch tactics). That framing asserts the standard exists to serve one implementer's product strategy -- inconsistent with this repo's own neutrality principle, and the exact issue CONTEXT.md's framing discipline section calls out.

  • Remove PRODUCT.md; add CONTEXT.md, which documents only what is true of the standard itself
  • CLAUDE.md's Product context section pointed at PRODUCT.md and repeated the same five-layer/Product Hunt framing -- updated to point at CONTEXT.md, and record growth is now described as bounded by distinct behavioral classes rather than an external launch target
  • research-new-attack-classes SKILL.md listed "before a release or Product Hunt push" as a trigger -- dropped the launch-event framing
  • Roadmap/adoption-tactics content (the real content of the old PRODUCT.md sections) now lives in TRUST_STRATEGY.md, kept outside this repo and gitignored, consistent with how the other local planning docs from earlier work on this repo are handled

Two dated docs/agents/ session records also mention PRODUCT.md; left alone as historical record, same treatment as CHANGELOG.md gets elsewhere in this repo.

Test plan

  • python3 scripts/validate_records.py -- all 59 records still valid
  • python3 -m pytest tests/ -q -- 118 passed
  • Repo-wide grep for five-layer|Layer 1 of the Bawbel|commercial moat|Product Hunt -- zero matches outside the two historical session docs
  • Confirmed nothing else in the repo links to PRODUCT.md besides CLAUDE.md (now fixed)

PRODUCT.md asserted AVE is "Layer 1 of the Bawbel five-layer
architecture" whose open layers "drive adoption" for a "commercial
moat," and carried a full adoption-strategy/roadmap section (Product
Hunt targets, launch tactics). That framing asserts the standard
exists to serve one implementer's product strategy, which cannot live
in this repo at any register, per the framing discipline CONTEXT.md
establishes explicitly.

- Remove PRODUCT.md; add CONTEXT.md, which contains only what is true
  of the standard itself. Roadmap/adoption-tactics content lives in
  TRUST_STRATEGY.md, kept outside this repo (gitignored).
- CLAUDE.md's Product context section pointed at PRODUCT.md and
  repeated the same five-layer/Product Hunt framing -- updated to
  point at CONTEXT.md and describe record growth as bounded by
  distinct behavioral classes, not an external target.
- research-new-attack-classes SKILL.md listed "before a release or
  Product Hunt push" as a trigger -- dropped the launch-event framing.

Two dated docs/agents/ session records also mention PRODUCT.md; left
alone as historical record, same treatment as CHANGELOG.md elsewhere
in this repo.
@chaksaray
chaksaray merged commit b04cc29 into develop Jul 17, 2026
6 checks passed
@chaksaray
chaksaray deleted the docs-context-replaces-product branch July 17, 2026 16:04
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.

1 participant