Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions .claude-plugin/marketplace.json
Original file line number Diff line number Diff line change
Expand Up @@ -6,14 +6,14 @@
},
"metadata": {
"description": "Loaf - An Opinionated Agentic Framework",
"version": "2.0.0-alpha.13"
"version": "2.0.0-alpha.14"
},
"plugins": [
{
"name": "loaf",
"description": "Loaf - An Opinionated Agentic Framework",
"source": "./plugins/loaf",
"version": "2.0.0-alpha.13",
"version": "2.0.0-alpha.14",
"license": "MIT",
"repository": "https://github.com/levifig/loaf"
}
Expand Down
11 changes: 11 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,9 +6,20 @@ is a Loaf workflow staging section for curated entries before release.

## [Unreleased]

- _No unreleased changes yet._

## [2.0.0-alpha.14] - 2026-07-25

### Added

- `loaf check --hook artifact-names` rejects artifact filenames that name the work unit which produced them. A Change, spec, task, or issue points at its artifacts; an artifact never points back, because the directory containing it already records that provenance, and a name carrying a work identity has to be renamed to stay true. The check runs fail-closed at commit time, judges tracked files only, matches Loaf's artifact directories by basename so relocating them needs no configuration, and grandfathers anything whose front matter records a terminal state (`final`, `archived`, `done`, or `completed`) at any nesting depth. Versions and timestamps remain legal because they identify rather than refer, as does a numbered record living in the directory that owns it, such as `SPEC-042` in `specs/` or `ADR-007` in `docs/decisions/`. **After upgrading, a commit that touches an artifact whose name carries a work identity fails until the file is renamed.** Run `loaf check --hook artifact-names --advisory` to list findings without blocking; record the provenance in a front matter field instead, where it stays readable and updatable.

### Changed

- Managed `AGENTS.md` fence markers are fingerprint-only (`sha256=` of the body, no installer version stamp), so `loaf install --upgrade` no longer rewrites the marker on every release when the body is unchanged. The first upgrade after this change strips the legacy `v…` stamp once; a pre-change binary that encounters the new header refuses with a malformed-fingerprint error until you upgrade the binary.
- Capability smoke runners require an explicit client executable, expected version, and receipt path, and publish a receipt only after both the proof and its cleanup succeed. Each runner is named for the target and context mode it verifies rather than for the workstream that commissioned it, its retained evidence follows the same rule, and marker prefixes are target-scoped so one target's proof cannot be presented as another's. Scripted callers must pass `--client`, `--expected-version`, and `--receipt`.
- Living project documentation and distributed skill guidance describe Change-first work in permanent language, without implementation-unit names, numbered development stages, or volatile inventory counts that go stale the moment anything is added. Historical Change, SPEC, and ADR citations remain where they serve as decision provenance.
- The `ship` skill handles pull requests stacked on the one being landed. It detects child pull requests before the merge, refuses to delete a head branch while a child still points at it, and afterwards retargets, rebases, and re-verifies each child. Neither repair is optional: GitHub does not reliably retarget a child when its base merges, and a squash merge leaves the child carrying commits that would re-apply its parent's entire diff.

## [2.0.0-alpha.13] - 2026-07-24

Expand Down
2 changes: 1 addition & 1 deletion dist/amp/.amp/plugins/loaf.ts
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
/**
* Amp Plugin - Agent Skills Hooks
* Auto-generated by loaf build system
* @version 2.0.0-alpha.13
* @version 2.0.0-alpha.14
*/

import type { PluginAPI } from '@ampcode/plugin';
Expand Down
4 changes: 2 additions & 2 deletions dist/amp/.loaf-target-manifest.json
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
{
"version": 1,
"target": "amp",
"package_version": "2.0.0-alpha.13",
"package_version": "2.0.0-alpha.14",
"capability_contract_version": 3,
"adapters": [
"amp-plugin-v1"
Expand All @@ -18,7 +18,7 @@
"kind": "plugin",
"source_path": ".amp/plugins/loaf.ts",
"destination": "plugins/loaf.ts",
"sha256": "3aca4420a45c57928cb4484bb3793ba519b8ff87ff10c6475829a84db1cdac5e",
"sha256": "ca3e112fb08144f458993e0c6f22e8cd65a8aa45c9ace4dd3de4da1eaacd8e52",
"mode": 420
}
]
Expand Down
2 changes: 1 addition & 1 deletion dist/amp/skills/architecture/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@ description: >-
`decision(scope)` entry to the project journal instead). The ADR log is
append-only — when circumstances change, write a new ADR that supersedes the
old one.
version: 2.0.0-alpha.13
version: 2.0.0-alpha.14
---

# Architecture
Expand Down
2 changes: 1 addition & 1 deletion dist/amp/skills/bootstrap/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ description: >-
I start a new project?", "set up Loaf," or "bootstrap my project." Produces
populated project documents and setup recommendations. Not for shaping
features (use shape) or brainstorming ideas (use brainstorm).
version: 2.0.0-alpha.13
version: 2.0.0-alpha.14
---

# Bootstrap
Expand Down
2 changes: 1 addition & 1 deletion dist/amp/skills/brainstorm/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ description: >-
capture. Explore owns the user-facing inquiry lifecycle; reference this
technique from it. Not a primary entry point — route "explore this" or "help
me think through options" to explore.
version: 2.0.0-alpha.13
version: 2.0.0-alpha.14
---

# Brainstorm
Expand Down
2 changes: 1 addition & 1 deletion dist/amp/skills/breakdown/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ description: >-
Use when the user asks "break this down" or "create tasks for this spec."
Produces task files with estimates, dependencies, and acceptance criteria. Not
for shaping ideas (use shape) or implementation work (use implement).
version: 2.0.0-alpha.13
version: 2.0.0-alpha.14
---

# Breakdown
Expand Down
2 changes: 1 addition & 1 deletion dist/amp/skills/council/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ description: >-
the user wants a structured debate between domain-specific viewpoints. Not for
single-perspective research (use research) or architectural decisions that
don't need multi-agent deliberation (use architecture).
version: 2.0.0-alpha.13
version: 2.0.0-alpha.14
---

# Council
Expand Down
2 changes: 1 addition & 1 deletion dist/amp/skills/database-design/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ description: >-
database administration and development. Not for ORM usage in application code
(use language-specific development skills) or infrastructure orchestration
(use infrastructure-management).
version: 2.0.0-alpha.13
version: 2.0.0-alpha.14
---

# Database Skill
Expand Down
2 changes: 1 addition & 1 deletion dist/amp/skills/debugging/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ description: >-
flaky tests. Provides methodology for root cause analysis and issue
resolution. Not for writing new tests (use development skills) or security
analysis (use security-compliance).
version: 2.0.0-alpha.13
version: 2.0.0-alpha.14
---

# Debugging
Expand Down
2 changes: 1 addition & 1 deletion dist/amp/skills/documentation-standards/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ description: >-
reviewing documentation quality, or creating architecture diagrams. Not for
inline code comments (use code style guides) or project READMEs (use
project-specific conventions).
version: 2.0.0-alpha.13
version: 2.0.0-alpha.14
---

# Documentation Standards
Expand Down
2 changes: 1 addition & 1 deletion dist/amp/skills/explore/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@ description: >-
research), continuing implementation or delivery work (use implement),
processing the intake queue (use triage), shaping a bounded Change (use
shape), or quick capture (use idea).
version: 2.0.0-alpha.13
version: 2.0.0-alpha.14
---

# Explore
Expand Down
2 changes: 1 addition & 1 deletion dist/amp/skills/foundations/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ description: >-
setting up project standards. Covers naming, TDD, verification, and review
workflows. Not for git workflow (use git-workflow), debugging (use debugging),
or security audits (use security-compliance).
version: 2.0.0-alpha.13
version: 2.0.0-alpha.14
---

# Code Standards
Expand Down
2 changes: 1 addition & 1 deletion dist/amp/skills/git-workflow/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ description: >-
PRs, or managing git history. Provides patterns for collaborative git
workflows. Not for code style (use foundations) or CI/CD pipelines (use
infrastructure-management).
version: 2.0.0-alpha.13
version: 2.0.0-alpha.14
---

# Git Workflow
Expand Down
2 changes: 1 addition & 1 deletion dist/amp/skills/go-development/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ description: >-
Follows Effective Go principles and community conventions. Not for database
schema design (use database-design) or infrastructure orchestration (use
infrastructure-management).
version: 2.0.0-alpha.13
version: 2.0.0-alpha.14
---

# Go Skill
Expand Down
2 changes: 1 addition & 1 deletion dist/amp/skills/handoff/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ description: >-
being parked for later. Not for routine journal continuity (use orchestration)
or an end-of-conversation checkpoint (use wrap). Produces a disposable handoff
artifact that housekeeping deletes after confirmed deprecation.
version: 2.0.0-alpha.13
version: 2.0.0-alpha.14
---

# Handoff
Expand Down
2 changes: 1 addition & 1 deletion dist/amp/skills/housekeeping/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ description: >-
completed work, and ensures extracted knowledge is preserved. Not for
strategic reflection (use reflect) or knowledge management (use
knowledge-base).
version: 2.0.0-alpha.13
version: 2.0.0-alpha.14
---

# Housekeeping
Expand Down
2 changes: 1 addition & 1 deletion dist/amp/skills/idea/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ description: >-
capture primitives routed through triage, which chooses dispositions such as
tracking an Intent. Not for divergent inquiry (use explore), processing the
intake queue (use triage), or shaping (use shape).
version: 2.0.0-alpha.13
version: 2.0.0-alpha.14
---

# Idea
Expand Down
2 changes: 1 addition & 1 deletion dist/amp/skills/implement/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ description: >-
changes. Logs to the project journal and produces agent spawn plans and
progress tracking. Not for shaping (use shape), breakdown (use breakdown),
research, or review.
version: 2.0.0-alpha.13
version: 2.0.0-alpha.14
---

# Implement
Expand Down
2 changes: 1 addition & 1 deletion dist/amp/skills/infrastructure-management/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ description: >-
managing deployments. Provides patterns for infrastructure as code. Not for
application code (use development skills), database schema (use
database-design), or security audits (use security-compliance).
version: 2.0.0-alpha.13
version: 2.0.0-alpha.14
---

# Infrastructure
Expand Down
2 changes: 1 addition & 1 deletion dist/amp/skills/interface-design/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ description: >-
ensuring accessibility compliance. Not for frontend code (use
typescript-development) or API design (use architecture or language-specific
skills).
version: 2.0.0-alpha.13
version: 2.0.0-alpha.14
---

# Design Principles
Expand Down
2 changes: 1 addition & 1 deletion dist/amp/skills/knowledge-base/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ description: >-
covers: field, and the review workflow. Not for retrieval or search (use QMD
directly), architectural decisions (use ADRs), or agent instructions (use
AGENTS.md).
version: 2.0.0-alpha.13
version: 2.0.0-alpha.14
---

# Knowledge Base
Expand Down
2 changes: 1 addition & 1 deletion dist/amp/skills/loaf-reference/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ description: >-
when asked to upgrade, diagnose, repair, configure, or bring a Loaf project
current. Not for workflow guidance (workflow skills own their CLI contracts)
or build internals.
version: 2.0.0-alpha.13
version: 2.0.0-alpha.14
---

# Loaf Reference
Expand Down
2 changes: 1 addition & 1 deletion dist/amp/skills/orchestration/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ description: >-
integration, and council workflows. Use when delegating to agents or
coordinating cross-cutting work across multiple agents. Not for single-task
implementation (use direct tool delegation) or solo research (use research).
version: 2.0.0-alpha.13
version: 2.0.0-alpha.14
---

# Orchestration
Expand Down
2 changes: 1 addition & 1 deletion dist/amp/skills/power-systems-modeling/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ description: >-
thermal calculations, validating conductors, or computing sag and resistance.
Not for infrastructure deployment (use infrastructure-management) or system
architecture.
version: 2.0.0-alpha.13
version: 2.0.0-alpha.14
---

# Power Systems Reference
Expand Down
2 changes: 1 addition & 1 deletion dist/amp/skills/python-development/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ description: >-
models, or tests. Provides patterns for modern Python development. Not for
schema design (use database-design), infrastructure (use
infrastructure-management), or frontend code (use typescript-development).
version: 2.0.0-alpha.13
version: 2.0.0-alpha.14
---

# Python Development
Expand Down
2 changes: 1 addition & 1 deletion dist/amp/skills/refactor-deepen/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ description: >-
improvements, or when the user asks "is this module too shallow?" or "where
should we deepen this code?" Produces either a read-only report or a PLAN file
with candidates, dependency categories, and proposed deepened modules.
version: 2.0.0-alpha.13
version: 2.0.0-alpha.14
---

# Refactor-Deepen
Expand Down
2 changes: 1 addition & 1 deletion dist/amp/skills/reflect/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ description: >-
VISION.md, STRATEGY.md, and ARCHITECTURE.md based on implementation
experience. Not for pre-implementation strategy (use strategy) or ADRs (use
architecture).
version: 2.0.0-alpha.13
version: 2.0.0-alpha.14
---

# Reflect
Expand Down
2 changes: 1 addition & 1 deletion dist/amp/skills/release/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ description: >-
a release," "publish a version," "release from main," or asks whether enough
landed work should become a release. Not for reviewing or merging a PR (use
ship).
version: 2.0.0-alpha.13
version: 2.0.0-alpha.14
---

# Release
Expand Down
2 changes: 1 addition & 1 deletion dist/amp/skills/research/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ description: >-
Produces state assessments, research findings with ranked options, or vision
change proposals. Not for multi-agent coordination (use orchestration) or
implementation.
version: 2.0.0-alpha.13
version: 2.0.0-alpha.14
---

# Research
Expand Down
2 changes: 1 addition & 1 deletion dist/amp/skills/ruby-development/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ description: >-
following Rails patterns. Follows DHH/37signals conventions. Not for database
schema design (use database-design) or frontend outside Hotwire (use
typescript-development).
version: 2.0.0-alpha.13
version: 2.0.0-alpha.14
---

# Ruby Development
Expand Down
2 changes: 1 addition & 1 deletion dist/amp/skills/security-compliance/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ description: >-
verification. Use when reviewing code for security, managing secrets,
performing threat analysis, or running compliance audits. Not for debugging
(use debugging) or general code review (use foundations).
version: 2.0.0-alpha.13
version: 2.0.0-alpha.14
---

# Security & Compliance
Expand Down
2 changes: 1 addition & 1 deletion dist/amp/skills/shape/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@ description: >-
conversations, and plain conversation as input. Produces a Change, never a
numbered spec or task file. Not for quick capture (use idea) or open-ended
divergent thinking before scope exists (use brainstorm).
version: 2.0.0-alpha.13
version: 2.0.0-alpha.14
---

# Shape
Expand Down
2 changes: 1 addition & 1 deletion dist/amp/skills/ship/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ description: >-
final merge gate. Produces a reviewed, squash-merged PR and post-merge
cleanup. Not for version bumps, tags, GitHub Releases, or install verification
(use release).
version: 2.0.0-alpha.13
version: 2.0.0-alpha.14
---

# Ship
Expand Down
2 changes: 1 addition & 1 deletion dist/amp/skills/strategy/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ description: >-
personas, market landscape analysis, and problem space definitions. Not for
architecture (use architecture) or post-implementation reflection (use
reflect).
version: 2.0.0-alpha.13
version: 2.0.0-alpha.14
---

# Strategy
Expand Down
2 changes: 1 addition & 1 deletion dist/amp/skills/triage/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ description: >-
shape. Not for reading a single known item (use loaf intent show or journal
directly), capturing new ideas (use idea), divergent inquiry (use explore), or
bounding one chosen direction (use shape).
version: 2.0.0-alpha.13
version: 2.0.0-alpha.14
---

# Triage
Expand Down
2 changes: 1 addition & 1 deletion dist/amp/skills/typescript-development/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ description: >-
CSS, and Vitest testing. Use when writing TypeScript applications, React
components, or Node.js services. Not for UI/UX design (use interface-design),
database schema (use database-design), or Python (use python-development).
version: 2.0.0-alpha.13
version: 2.0.0-alpha.14
---

# TypeScript Development
Expand Down
2 changes: 1 addition & 1 deletion dist/amp/skills/wrap/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ description: >-
end of a work session or when the user asks "wrap up." Not for archiving (use
housekeeping) or capturing ideas (use idea). Produces a Session Wrap-Up
summary and an optional wrap journal entry.
version: 2.0.0-alpha.13
version: 2.0.0-alpha.14
---

# Wrap
Expand Down
2 changes: 1 addition & 1 deletion dist/codex/.loaf-target-manifest.json
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
{
"version": 1,
"target": "codex",
"package_version": "2.0.0-alpha.13",
"package_version": "2.0.0-alpha.14",
"capability_contract_version": 3,
"adapters": [
"codex-session-start-v1"
Expand Down
2 changes: 1 addition & 1 deletion dist/codex/skills/architecture/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@ description: >-
`decision(scope)` entry to the project journal instead). The ADR log is
append-only — when circumstances change, write a new ADR that supersedes the
old one.
version: 2.0.0-alpha.13
version: 2.0.0-alpha.14
---

# Architecture
Expand Down
Loading
Loading