Skip to content

v3.3.0: Shell Integration + Executable Knowledge Ontology

Choose a tag to compare

@gmelli gmelli released this 11 Jan 06:19
· 602 commits to main since this release

Shell Integration + Executable Knowledge Ontology

Released: 2026-01-10

Highlights

  • Shell Orchestration: aget.zsh, profiles.zsh with 5 CLI backend profiles (Claude Code, Cursor, Aider, Windsurf, manual)
  • SKOS-Compliant Vocabularies: All 12 templates now have specs/*_VOCABULARY.md with formal definitions
  • Ontology-Driven Creation (L481, L482): Specifications drive agent instances, not follow them
  • R-REL-015: "We do not leave published templates behind" - template governance principle

New Specifications

  • AGET_EXECUTABLE_KNOWLEDGE_SPEC.md: Executable knowledge framework (scripts, validators, patterns)
  • AGET_EVOLUTION_SPEC.md: Evolution entry standardization (L-prefix, D-prefix, DISC-prefix)

New Validators

  • validate_ontology_compliance.py: Template vocabulary validator (SKOS compliance)
  • generate_template_ontology.py: Ontology generator for templates
  • validate_artifact_size.py: Artifact comprehensibility validator

Learnings

18 new L-docs: L451-L503 covering:

  • L451: Executable Knowledge Ontology
  • L452: Shell Orchestration Pattern
  • L481: Ontology-Driven Agent Creation
  • L482: Executable Ontology - SKOS+EARS Grounding
  • L500-L503: Permission governance, artifact comprehensibility

Template Migration

All 12 templates updated with SKOS-compliant vocabularies:

  • template-advisor-aget, template-analyst-aget, template-architect-aget
  • template-consultant-aget, template-developer-aget, template-executive-aget
  • template-operator-aget, template-researcher-aget, template-reviewer-aget
  • template-spec-engineer-aget, template-supervisor-aget, template-worker-aget

Full Changelog

See CHANGELOG.md for detailed changes.

Upgrade Notes

This is a minor version bump with no breaking changes. Templates at v3.3.x are compatible with aget v3.3.y.