v3.18.0 — Framework Alignment

Theme: Aligned with framework v3.18.0 (Substrate Hygiene + Memory-Layer Self-Application; Hybrid A primary + B-tagged streams)

What's New

• Version bump: 3.17.0 → 3.18.0 (framework alignment); .aget/version.json aget_version + CHANGELOG.md v3.18.0 entry updated.
• AGET_MEMORY_SURFACE_SPEC v0.2.0 canonical available at aget/specs/AGET_MEMORY_SURFACE_SPEC.md (harness-vs-KB taxonomy; R-MS + V-MS + CAP-MS contracts at LANDED rigor).
• Verb Registry refreshed (T1.9 / PP-021): 37 Active + 4 Reserved verbs + 11 §Hierarchy Decisions pairs at aget/ontology/DESIGN_DIRECTION_skill_verb_vocabulary.md. Agents authoring new skill names: apply L954 5-line vocabulary pre-check.
• /aget-create-initiative Strict promotion: D71 verb-pair gap closed. Direct authoring of planning/initiatives/INIT-*.md now PROHIBITED unless skill invoked. Three Strict skills now: /aget-create-project, /aget-create-initiative, /aget-file-issue.
• Homepage Fork C Hybrid at canonical aget-framework: org-profile inline releases bounded v3.10+; ## Roadmap → ## Release History; REQ-HOM v1.2.0 + release_homepage_update.py Generator; L941-L944 cluster closed.
• /aget-go capture wiring (T1.8 + T1.10): SKILL-024 v1.3.0 REQ-PA-006a Batch GO Capture; GO-record telemetry surfaced at session-close per L178.

Sleeping-CAPs Disclosure

NONE new at this template at v3.18. Framework-level CAP-REL-032 + CAP-REL-033 GRACE-EXTENDED to v3.19.0 (R-DEP-4 explicit IMPLEMENT commitment). See framework v3.18.0 release for details.

Compatibility

No breaking changes. Existing instances upgrade by version-bump only. Optional: adopt /aget-create-initiative for new initiative authoring; consult refreshed verb registry before naming new skills. See CHANGELOG.md and framework v3.18.0 release for full Tier 1 + Tier 2 (PARTIAL) deliverable list + DEFECT-2/4 acknowledgment.

v3.17.0 — Theme C3: Canonical Coherence + Structural Self-Conformance

Theme: Aligned with framework v3.17.0 (Theme C3 — Canonical Coherence + Structural Self-Conformance)

What's New

• Version bump: 3.16.0 → 3.17.0 (framework alignment); .aget/version.json aget_version + AGENTS.md @aget-version + CHANGELOG.md v3.17.0 entry updated.
• framework-manager archetype formalized (Q4=A.2): NEW archetype for framework-management agents; existing archetype values continue to function (additive).
• T2.18 + T2.19 LANDED: SOP_scope_lock_ceremony.md v1.0.0 (codifies 4-gate scope-lock ceremony) + AGET_SKILL_LIFECYCLE_SPEC v1.0.0 with full V-test authoring (7 CAPs, no sleeping V-tests).
• T2.20 + T2.23 DRAFT: AGET_FLEET_UPGRADE_SPEC + AGET_TASK_ROUTING_SPEC v0.1.0 DRAFT (calibrated demote per L103; LANDED queued v3.18).
• CAP-REL-030 + CAP-REL-031 IMPLEMENTED: Post-Release CHANGELOG Validator + Tag Validator (closes v3.16 sleeping CAPs); CAP-REL-032 + CAP-REL-033 grace-extended v3.18.0.
• CAP-REL-006-02-NN + CAP-REL-008b/c spec amendments: 17-cycle release-body sparseness + 5-cycle template README stale + org-profile drift structurally remediated; 3 paired V-tests + SOP Phase 5.5 + 6.5 gates BLOCKING at v3.18+.

Sleeping-CAPs Disclosure

NONE new at this template at v3.17. Framework-level CAP-REL-032 + CAP-REL-033 grace-extended; see framework v3.17.0 release for details.

Compatibility

No breaking changes. Existing instances upgrade by version-bump only. Optional adoption: framework-manager archetype field in .aget/identity.json for framework-management agents. See CHANGELOG.md and AGET_DELTA_v3.17.md.

v3.16.0 - Framework-Discipline Closure + Wave-1A Spec Contracts

[3.16.0] - 2026-05-02

Theme: Aligned with framework v3.16.0 (Framework-Discipline Closure + Wave-1A Spec Contracts + /aget-go Production)

Changed

• Version bump: 3.15.0 → 3.16.0 (framework alignment)
• AGENTS.md @aget-version updated to 3.16.0
• No .claude/skills/ baseline present (template lacks universal-skill deployment per L671 dormant classification; addressed at v3.17 grooming via #1121 lifecycle decision).

Compatibility

• No breaking changes in v3.16. Existing instances upgrade by version-bump only.
• Optional adoption: **Plan_Status**: / **Gate_Status:** schema in new PROJECT_PLAN files (CAP-PP-003 disambiguation; backward-compatible).

---

v3.15.0 — Framework alignment: Security + Cadence + BC-001/BC-002

Framework release v3.15.0. See aget-framework/aget v3.15.0 for full release notes.

Breaking changes in this release:

• BC-001: version.json old field names removed
• BC-002: --fix flag removed from skill surfaces; use /aget-enhance-health instead

New in this release:

• /aget-enhance-health skill (SKILL-049 v1.0.0)
• AGET_SECURITY_SPEC v0.2 + AGET_BUDGET_GRAMMAR_SPEC v0.2
• POL-REL-001 weekly Saturday release policy

v3.14.0 — aligned with framework

v3.14.0 — aligned with framework

This template tracks aget-framework/aget v3.14.0. See the framework release for full context:

• Framework release: aget-framework/aget v3.14.0
• CHANGELOG: this repository's CHANGELOG.md v3.14.0 entry for any template-specific changes
• Handoff: RELEASE_HANDOFF_v3.14.0.md

Template changes this release: version bump, AGENTS.md @aget-version bump, CHANGELOG entry. Some templates additionally received a housekeeping_protocol.py → health_check.py rename fix in the installer templates.

Per v3.14.0 deprecation policy, session-script filename renames (wake_up.py → aget_open_session.py, wind_down.py → aget_close_session.py) are announced with 2-minor-version grace (removal in v3.16.0). Old names continue to work through v3.15.0.

v3.13.0

v3.13.0 — Operational Maturation & Fleet Automation

Key additions:

• validate_release_gate.py: structural exit-code enforcement (L784 fix)
• fleet_upgrade.py: single-script fleet migration (25-40 prompts → ≤5)
• Release Delivery Triad v0.2.0 (Builder/Spec Auditor/Critic)
• 8 new skills (24→31) with telemetry infrastructure
• Health check orchestration spec (3 tiers)
• Wind-down display format spec
• Governed Discourse Boundary spec
• Script divergence tracker
• Migration completion report template

Full release notes: https://github.com/aget-framework/aget

v3.12.0 -

See https://github.com/aget-framework/aget/blob/main/specs/deltas/AGET_DELTA_v3.12.md for complete changes.

v3.11.1 - Script Rename Stabilization

Script Rename Stabilization

See https://github.com/aget-framework/aget/blob/main/specs/deltas/AGET_DELTA_v3.11.md for complete changes.

v2.8.0 - Format Preservation Framework

Format Preservation Framework

Template Version: v2.8.0 (incremental from v2.7.0)
AGET Framework: v2.7.0
Base Template: worker

What's New

This release adds Format Preservation Framework to prevent L245-type catastrophic failures (100% Track Changes loss that cost docx-AGET 10 hours of wasted work).

Key Features

OOXML Verification Module (.aget/tools/format_verification/):

• Track Changes verification (insertions, deletions)
• Comments preservation detection
• Round-trip validation (before → process → after)
• Multi-stage checkpoint system for pipeline verification
• L245 failure detection (100% format loss prevention)

Decision Protocol:

• FORMAT_PRESERVING_DECISION_PROTOCOL.md - 5-question architecture checklist
• Helps agents choose between text-only vs format-preserving processing

Documentation:

• FORMAT_PRESERVATION_GUIDE.md - Simple-first implementation guide (59% Quick Start, 41% Advanced)
• Integration example: examples/verify_track_changes_example.py (copy-paste ready)

Testing:

• 15 integration tests with real DOCX files
• Programmatic DOCX creation with Track Changes markup
• Test coverage: Overall 53%, docx_verifier.py 68% (exceeds 60% target)

Versioning

This release introduces dual versioning for specialized templates:

• template_version: 2.8.0 (template-specific features, incremental from v2.7.0)
• aget_version: 2.7.0 (framework compliance)
• template_base: "worker" (base template)

Template started at v2.7.0 (Oct 2025), first enhancement → v2.8.0 (Nov 2025). Reserves v3.0.0 for future major enhancements.

Validation

Dogfooding: 3min 18sec pilot agent creation using Quick Start only
L245 Detection: 100% format loss correctly detected with real DOCX files
Test Suite: 62 tests (all passing)

Migration

Backward Compatible: Zero breaking changes. Format preservation is opt-in.

See MIGRATION_v2.7_to_v2.8.md for upgrade guide.

Impact

• Prevents L245-type failures (100% Track Changes loss)
• Decision framework for architecture choice (text-only vs format-preserving)
• Template versioning pattern (see L250 in supervisor repo)

Files Changed

Added (15 files):

• Format verification module (5 Python files)
• Integration tests (15 tests with real DOCX)
• Documentation (2 protocols + 1 guide)
• Migration guide
• Test fixtures

Modified (5 files):

• version.json (dual versioning)
• README.md (versioning clarification)
• CHANGELOG.md
• Contract tests

Total: 20 files changed, +4,178 insertions, -16 deletions

---

Full Changelog: See CHANGELOG.md
Learning Document: L250_template_version_control_pattern.md (supervisor repo)

🤖 Generated with Claude Code

v2.7.0 - Document Processing Agent Template

template-document-processor-AGET v2.7.0

Initial Public Release 🎉

A production-ready template for creating document processing agents with LLM pipelines, security protocols, and multi-provider support.

Overview

This template provides a complete foundation for agents that process documents using LLM assistance, with built-in support for batch operations, validation pipelines, security protocols, caching, metrics, and observability.

Based on: L208: Document Processing Agent Template Pattern (analysis of production document processing agents)

Time Savings: 60-70% reduction in new agent setup (3-5 hours → 1-2 hours)

Key Features

Core Infrastructure (20 Source Modules)

• src/ingestion/ (3 modules) - Queue management, validation, batch processing
• src/processing/ (5 modules) - LLM providers, model routing, caching, schema validation
• src/output/ (3 modules) - Publishing, version management, rollback
• src/security/ (3 modules) - Input sanitization, content filtering, resource limiting
• src/pipeline/ (4 modules) - Task decomposition, orchestration, metrics
• src/wikitext/ (2 modules) - Domain-specific support (extensible for other formats)

Configuration Framework (9 YAMLs)

• Document validation rules
• LLM provider configuration (OpenAI, Anthropic, Google)
• Model routing strategy
• Security policy
• Processing limits (tokens, time, cost)
• Caching settings
• Metrics collection
• Orchestration rules

Operational Protocols (9 Documented)

1. Queue Management Protocol
2. Processing Authorization Protocol
3. Validation Pipeline Protocol
4. Rollback Protocol
5. Security Validation Protocol
6. Task Decomposition Protocol
7. Model Routing Protocol
8. Caching Implementation Protocol
9. Metrics Collection Protocol

Tools & Scripts (17 Total)

• 15 operational scripts: validate, process, queue management, rollback, metrics, health checks, security validation, audit trail
• 2 helper tools: agent fit analysis, template instantiation

Quality Assurance

• 30 contract tests (100% passing)
  • 20 smoke tests (all modules)
  • 10 integration tests (end-to-end workflows)
• 3 formal specifications (168 EARS requirements)
• Privacy-safe (no private agent references)
• Apache 2.0 licensed

Quick Start

# Clone template
gh repo clone aget-framework/template-document-processor-AGET my-document-agent
cd my-document-agent

# Customize configuration
# Update .aget/version.json, configs/*.yaml, AGENTS.md

# Run tests
python3 -m pytest tests/ -v

# Deploy
git remote set-url origin <your-repo-url>
git push -u origin main

Customization Points

1. Document Validation - File types, size limits, format rules
2. LLM Providers - API keys, model selection, fallback chain
3. Security - Input sanitization, content filtering, resource limits
4. Metrics - Accuracy tracking, latency monitoring, cost tracking

See README.md for complete customization guide.

Template Capabilities

✅ Multi-provider LLM support (OpenAI, Anthropic, Google)
✅ Batch operations with validation pipelines
✅ Security protocols (prompt injection prevention, content filtering)
✅ Caching and metrics for cost/performance optimization
✅ Task decomposition for large documents
✅ Rollback and version management
✅ Wikitext support (extensible to PDF, DOCX, etc.)

Version History

v2.7.0 (2025-10-26) - Initial template release

• Based on L208 document processing pattern analysis
• 20 source modules (Gate 2A: 8, Gate 2B: 7, Gate 2C: 5)
• 9 configuration files (YAML-based)
• 9 operational protocols (tested and validated)
• 3 formal specifications (168 EARS requirements)
• 17 operational tools (15 scripts + 2 helper tools)
• 30 contract tests (20 smoke + 10 integration, 100% passing)

Support

• Template Repository: https://github.com/aget-framework/template-document-processor-AGET
• AGET Framework: https://github.com/aget-framework
• Issues: https://github.com/aget-framework/template-document-processor-AGET/issues

License

Licensed under the Apache License, Version 2.0. See LICENSE file for details.

Copyright 2025 AGET Framework Contributors

---

Generated by AGET v2.7.0