AgentSpec V0.1 — 3.5.0

The first tagged release of AgentSpec — the V0.1 product milestone, carrying plugin version 3.5.0.

Marketplace installs had been frozen at 3.2.0 since May: every feature merged since then shipped without a version change, so client updaters never fired. This release delivers the catch-up and the guardrails that make a silent version freeze impossible from here on.

Highlights

• spec-linter (structural gate) — deterministic contract validation for agent specs, as plain YAML or self-contained agent.md frontmatter, with a three-way exit-code contract (PASS/WARN = 0, FAIL = 1, operational ERROR = 2), recursive fleet mode with per-file ERROR reporting, and a cross-file duplicate-id check.
• spec-judge (behavioral gate) — adversarial behavioral evaluation of agent specs with cross-model consensus; advisory by default, blocking only for high-assurance opt-in consumers; fully offline-testable by construction.
• Component model + skills suite — agents as thin executors over skills (agents EXECUTE, skills teach HOW, commands are ENTRYPOINTS, KBs are SOURCE OF TRUTH); per-phase SDD skills; a GitHub workflow trio for drafting and guarded publishing of ADRs and issues.
• Marketplace install fixed end-to-end — claude plugin marketplace add luanmorenommaciel/agentspec resolves the root manifest correctly, and the root manifest is auto-regenerated on every build so the two copies cannot drift.
• Version-bump gate — pull requests to main that touch shipped content must carry a strictly greater semver; the three plugin manifests must agree before any comparison; develop holds the version equal to main so bumps land only in release PRs.
• Deterministic end-to-end CI — every PR performs a real headless marketplace install into a clean HOME, asserts source-vs-installed artifact counts, and exercises both engines' exit-code contracts from the installed copy; a report-only fleet-conformance counter tracks the agent-spec burn-down until it flips blocking at zero.

Full details in CHANGELOG.md.