From 9ed82938c31e0d7fb0bef75e334a9e80e8ab3165 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Mauricio=20S=C3=A1nchez?= Date: Mon, 5 Oct 2026 22:59:33 -0500 Subject: [PATCH] =?UTF-8?q?docs:=20release=20v1.2.0=20=E2=80=94=20the=20re?= =?UTF-8?q?ference=20docs=20come=20from=20the=20plugin?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit A minor release: a packaged project no longer commits the framework's four reference docs; it reads them from the pinned plugin (#33, decision 0019). Unreleased becomes v1.2.0, with the upgrade from v1.1.x: /aplyca-adf:upgrade moves the pin and, in a packaged project, removes the unchanged copies, rewrites the links, adds the read rule, and extends the names note. plugin.json 1.2.0; both READMEs name the release. Co-Authored-By: Claude Opus 5.5 --- CHANGELOG.md | 16 ++++++++++++++++ README.md | 3 ++- plugins/aplyca-adf/.claude-plugin/plugin.json | 4 ++-- plugins/aplyca-adf/README.md | 2 +- 4 files changed, 21 insertions(+), 4 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 54d48e8..5912ab8 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -11,6 +11,22 @@ For each entry, **Upgrade impact** classifies the change against the [three-buck ## Unreleased +## v1.2.0 — 2026-10-05 — The reference docs come from the plugin + +A minor release. A packaged project no longer commits the framework's four reference docs: it reads +them from the pinned plugin +([#33](https://github.com/Aplyca/AgenticDevelopmentFramework/pull/33), decision 0019). Nothing changes +for a committed project but two overwritten files. + +**Upgrading from v1.1.x:** `/aplyca-adf:upgrade` moves the pin to `v1.2.0`. In a packaged project it +also: +- deletes the four docs from `docs/` where they're unchanged; +- points their links at the release; +- adds the plugin's read rule to the settings; +- adds one sentence to the names note in `CLAUDE.md`. + +A baseline older than v1.0.0 takes v1.0.0's order to upgrade in first. + ### A packaged project reads the framework's reference docs from the plugin ([0019](docs/decisions/0019-reference-docs-in-the-plugin.md), amending [0016](docs/decisions/0016-packaged-install.md)) diff --git a/README.md b/README.md index 8310f75..cb3c3a4 100644 --- a/README.md +++ b/README.md @@ -141,7 +141,8 @@ Updates are deliberate: `/aplyca-adf:upgrade` moves a project from one release t pull request and keeps its customizations. Read the **Upgrade impact** of each release in [CHANGELOG.md](CHANGELOG.md) first. From v1.0.0, releases follow semantic versioning ([decision 0017](docs/decisions/0017-semantic-versioning.md)), so a major release asks something of your team. -The latest, **v1.1.0** (2026-10-04), makes the packaged install the default for new projects. +The latest, **v1.2.0** (2026-10-05), moves the framework's reference docs out of packaged projects +and into the plugin. **v1.0.0** (2026-10-02) renamed the plugin `aplyca-adf` and opens with the order to upgrade in. A baseline older than `7383422` takes that release's order first, and one older than `3eb7777` takes its three fixes before that — they affect every adopted repository. diff --git a/plugins/aplyca-adf/.claude-plugin/plugin.json b/plugins/aplyca-adf/.claude-plugin/plugin.json index 0c295b6..b302689 100644 --- a/plugins/aplyca-adf/.claude-plugin/plugin.json +++ b/plugins/aplyca-adf/.claude-plugin/plugin.json @@ -1,7 +1,7 @@ { "name": "aplyca-adf", - "description": "The Agentic Development Framework for Claude Code. /adopt bootstraps a repository — skeleton, optional modules, guardrail hooks, verified facts — committed or packaged; /upgrade moves an adopted repository to a newer release; /cost-report shows what agent sessions cost, from local transcripts. In a packaged project it also carries the framework's skills, agents, workflows, and hooks, pinned to a release; in a committed project those step aside for the committed copies.", - "version": "1.1.0", + "description": "The Agentic Development Framework for Claude Code. /adopt bootstraps a repository — skeleton, optional modules, guardrail hooks, verified facts — committed or packaged; /upgrade moves an adopted repository to a newer release; /cost-report shows what agent sessions cost, from local transcripts. In a packaged project it also carries the framework's skills, agents, workflows, hooks, and reference docs, pinned to a release; in a committed project those step aside for the committed copies.", + "version": "1.2.0", "author": { "name": "Aplyca", "email": "dev@aplyca.com" diff --git a/plugins/aplyca-adf/README.md b/plugins/aplyca-adf/README.md index 99cbfde..0e1a774 100644 --- a/plugins/aplyca-adf/README.md +++ b/plugins/aplyca-adf/README.md @@ -146,7 +146,7 @@ the plugin by a relative path. A machine where nobody trusts the folder — CI { "extraKnownMarketplaces": { "aplyca": { - "source": { "source": "github", "repo": "aplyca/AgenticDevelopmentFramework", "ref": "v1.1.0" } + "source": { "source": "github", "repo": "aplyca/AgenticDevelopmentFramework", "ref": "v1.2.0" } } }, "enabledPlugins": { "aplyca-adf@aplyca": true }