CLAUDE.md git:20261107.b12d826A

Immutable. This exact content never changes and is served at /api/v1/blob/ed332b633e83a68f.

# subscription-skills — project memory

A Claude marketplace and plugin, `subscription-skills`: the paywall and its numbers for subscription apps. Author: Ivan Polushin (theoutlines). Public repo; original text CC BY 4.0, Adapty's two skills MIT.

## Product split (agreed 2026-10-30)
- This plugin = the paywall and the testing mechanics around it: benchmark reports (RevenueCat SOSA 2026, Adapty State of In-App Subscriptions 2026, FunnelFox Web2App 2026), Adapty Pricing Index, `subscription-benchmarks` router, `paywall-store-compliance`, and Adapty's `paywall-teardown` and `paywall-ab-test-assistant`. Self-contained: one install, everything included.
- Growth work beyond the paywall (onboarding, flow, upsell, retention, cancel flow, web2app) lives in theoutlines/growth-skills, which is private and paid since 2026-11-07 and copies these skills in before each release. This plugin stays free and public; never link to growth-skills from here. Keep the plugin path `plugins/subscription-skills` stable.
- Removed for good: Apple Ads and AppsFlyer skills (not designer work), Recurly. Standalone per-skill repos are deleted.

## Layout
- `.claude-plugin/marketplace.json` at the root; plugin at `plugins/subscription-skills/` (9 skills). `paywall-rules` (2026-11-07): store must-haves and published wins and losses for agents that build paywalls in code; a free demand test for the Paywall Pack idea (signal: installs on skills.sh). Use only results already public in the planner (`js/data.js` TESTS) or in this repo; never copy from the private growth-skills base.
- Our skills are edited in place in `plugins/subscription-skills/skills/`. `scripts/sync.sh` only pulls Adapty's two skills from upstream (github.com/vkharlan-adapt) and subsets their fonts.
- Adapty's State of Paywalls is not bundled (no MIT licence yet); the router uses it when installed. Bundle it once the licence lands.

## Rules
- Public sources only; never employer data. Never invent a number; every figure keeps its source and denominator (per install vs per trial start vs per paywall view vs per web visitor). Each report skill keeps an Errata section.
- Bump `version` in plugin.json and the marketplace entry on every release, and add `.github/release-notes/vX.Y.Z.md`. Pushing the version change to main runs `.github/workflows/release.yml`, which zips each skill and publishes the release (tag pushes and the releases API are blocked from this session). Repo settings (About, topics) are changed through the owner's signed-in Chrome.
- Run `claude plugin validate .` and `claude plugin validate plugins/subscription-skills` before every push.

## Status (Oct 2026)
- v1.3.0 (9 skills, + paywall-rules). v1.2.0 (8 skills). Submitted to the Anthropic directory earlier; development continues without waiting for the review.