Spec: AI agent workflow
This flow describes the recurring workflow for project-bound AI work.
Purpose
- execute AI work reproducibly, source-based, and repo-cleanly
Trigger
- user request or follow-up work inside an existing issue
Participating systems
Inputs and outputs
- Inputs:
- task, context, source hints
- Outputs:
- implemented change, public work doc, optional round note
Flow
- load the matching skills and rules
- clarify scope, Jira reference, and target repos
- inspect sources in docs, skill repos, and the
tagebuch - implement changes repo by repo
- follow up docs, commits, and evidence
Handovers
- user request -> skill workflow
- source check -> repo work
- repo work -> public docs and commit
Boundaries and non-goals
- no implicit scope expansion
- no mixed multi-repo commits
Links to operational docs
Sources
skills/koordination/SKILL.mdskills/docs-i18n/SKILL.mdskills/jira-state-sync/SKILL.md- J01-113: rule inventory appendix