The AI/skill framework is the versioned work and rule system for project-bound AI work in the workspace.

What it is

  • the combination of workspace AGENTS.md, skill repos, and project-bound skills
  • the layer for recurring AI workflows, repo coordination, and rule separation
  • the home of reference and execution logic for AI work

What it is not

  • not the public long form of all project rules
  • not the product itself
  • not the raw notes system

Why

  • AI work needs versioned, reusable, project-bound workflows
  • skills should link project knowledge instead of duplicating it

Structure

  • shared skills
  • project-specific skill repos
  • project-bound skills such as koordination, docs-i18n, jira-state-sync

Roles

  • shared skills carry general method
  • project skills carry concrete workflows and project binding
  • workspace AGENTS.md stays bootstrap instead of domain home

Interfaces

  • points to the Docs system and Specs
  • uses the tagebuch for provenance
  • works with Jira and the repo system

Current state and target picture

  • Current state:
    • project map, skills, and rule work already exist
  • Target picture:
    • specs become additional canonical targets for skill references

Parent systems

Child systems

  • shared skills
  • project skills
  • cache and script paths

Sources