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
16 changes: 16 additions & 0 deletions .aap/map.yaml
Original file line number Diff line number Diff line change
@@ -0,0 +1,16 @@
version: 2
workspace:
id: agent-artifact-protocol
description: "The AAP specification, its JSON Schemas, examples, the aap-map skill and the optional cookbook."
self:
id: agent-artifact-protocol
kind: repository
path: .
layout:
# REVIEW: the spec itself is SPEC.md at the repository root; layout keys point at folders, so it has no key
schemas: schemas/
skills: skills/
examples: examples/
cookbook: cookbook/
scripts: scripts/
nodes: []
12 changes: 12 additions & 0 deletions .claude-plugin/marketplace.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,12 @@
{
"name": "agent-artifact-protocol",
"description": "Skills for the Agent Artifact Protocol (AAP), a repository map for coding agents",
"owner": { "name": "gitpash" },
"plugins": [
{
"name": "aap",
"source": "./",
"description": "aap-map: write a minimal .aap/map.yaml for any repository, with uncertain parts marked for human review."
}
]
}
9 changes: 9 additions & 0 deletions .claude-plugin/plugin.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,9 @@
{
"name": "aap",
"version": "0.3.0",
"description": "The aap-map skill writes a minimal .aap/map.yaml for a repository and marks its guesses for human review.",
"author": { "name": "gitpash" },
"repository": "https://github.com/gitpash/agent-artifact-protocol",
"license": "MIT",
"keywords": ["aap", "repository-map", "agent-context", "skill"]
}
25 changes: 23 additions & 2 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -1,8 +1,29 @@
# Changelog

## Unreleased
## 0.3.0 — 2026-10-28

(nothing yet)
First release with an agent entry point and an installable skill. The Map v2 schema and its semantics are unchanged from 0.2.0. The "-prototype" suffix is dropped from the version: the project is still experimental, and the README Status section says so in one place.

### Added

- `skills/aap-map/`: an agent skill (one `SKILL.md`, no dependencies) that inspects a repository, writes a minimal `.aap/map.yaml` and marks guesses with `# REVIEW:` comments.
- One-command install: `npx skills add gitpash/agent-artifact-protocol`, or in Claude Code `/plugin marketplace add gitpash/agent-artifact-protocol` and `/plugin install aap@agent-artifact-protocol` (`.claude-plugin/` manifests).
- `llms.txt`: an agent-readable entry point (what AAP is, what to open first, the `access` rules, links).
- `.aap/map.yaml`: this repository's own map, written with the skill and checked by `scripts/validate.py`.
- `docs/skill-tests.md`: how the skill was tested and what changed as a result.

### Changed

- README rewritten for newcomers: install first, quick start, minimal example, one Status section. Conformance labels moved into `SPEC.md`.
- `MOTIVATION.md` moved to `docs/motivation.md`; its pilot metrics sketch was removed (`cookbook/measuring.md` covers the method).
- Cookbook index is a plain list. Per-page "Profile status" lines were removed.
- Example pins in the cookbook now use `v0.3.0`.
- `schemas/map.schema.json`: `$id` now points at the tagged raw URL in this repository instead of a gist (the template editor hint likewise), and the top-level `description` no longer says "Pilot". Validation is unchanged.

### Removed

- `legacy/v1/` (the v1 zones map). It stays in git history and in the `v0.1.1-draft` tag.
- Cookbook pages `glass-box-factory.md`, `orchestrator-session.md` and `what-not-to-copy.md`. They described tooling and provenance that this repository does not ship.

## 0.2.1-prototype — 2026-10-16

Expand Down
9 changes: 4 additions & 5 deletions CONTRIBUTING.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,9 +6,9 @@ Thank you for helping keep the Core **small**.

| Place | Form |
|-------|------|
| Documents / CHANGELOG | `0.2.1-prototype` (no `v`) |
| Git tags | `v0.2.1-prototype` (with `v`) |
| Prior Core intro label | `0.2.0-draft` / historical commits — Map v2 rules unchanged in `0.2.1-prototype` |
| Documents / CHANGELOG | `0.3.0` (no `v`) |
| Git tags | `v0.3.0` (with `v`) |
| Earlier labels | `0.2.1-prototype`, `0.2.0-draft`; Map v2 rules are unchanged since `0.2.0-draft` |

## What belongs in Core vs elsewhere

Expand All @@ -22,7 +22,7 @@ Thank you for helping keep the Core **small**.
| Deployment-defined mode labels | Universal role vocabulary |
| Schema shape validation | Cross-file linters beyond seed |
| | **Stream packs**, **accept / done bars**, **orientation cards**, **local dispatcher** templates |
| | Hub-umbrella teaching, glass-box factory *pattern*, orchestrator-session *shape* |
| | Hub-umbrella teaching |
| | Schema-pinning ops notes, brownfield init prose |

### Profile PRs are not Core MUST
Expand All @@ -32,7 +32,6 @@ Pull requests that add or edit:
- stream pack samples / templates
- accept-default / done-bar checklists
- thin orientation cards
- factory or multi-agent session **stories**

…are **profile / cookbook** changes. Reviewers **MUST NOT** treat them as new Orientation requirements or as justification to grow mandatory L0. Optional profiles stay optional even when examples look polished.

Expand Down
Loading
Loading