IMS Content Sprint Workflow¶
Detailed end-to-end process for a content development sprint.
Pre-Sprint¶
- Ensure you're on
mainbranch and up to date:git checkout main && git pull - Create sprint branch:
git checkout -b feature/ims-content-sprint-N
Phase 1: Plan (10 min)¶
- Run
/vt-v-planto generate or update the sprint backlog - Review the backlog with the user
- Agree on scope: which domain, which files, how many
- Set batch size (default: 20-30 files)
Phase 2: Write (bulk of sprint)¶
Batch Processing Loop¶
For each batch of files:
- Select files from sprint backlog (same domain per batch)
- Load references appropriate for the domain:
- ISMS:
control-patterns.md,reifegrad-criteria.md,norm-mapping.md - DSMS:
vvt-exemplars.md,rechtsgrundlagen.md,tom-art32-reference.md - QMS/IMS:
control-patterns.md - Route to domain agent:
- ISMS →
isms-expertagent - DSMS →
dsms-expertagent - QMS/IMS →
qms-ims-expertagent - Agent writes content for each file:
- Read the existing file
- Read related policies/evidence
- Write/enrich the content
- Update YAML frontmatter
- Track progress via TodoWrite
Important Rules During Writing¶
- Always read the file before writing — preserve existing structure
- Don't remove Dataview queries or navigation links
- Use
[[wiki-links]]for cross-references (not raw file paths) - Set
review_dateto one year from today - Set
approved_by: Rolf Schulte Strathaus - Set
approved_dateto today - Write all content in German
Phase 3: Audit (5 min per batch)¶
After each batch:
- Run
/vt-v-audit --changedto validate the batch - Review errors — fix immediately:
- Missing Pflichtfelder → add them
- Invalid enum values → correct them
- Broken wiki-links → fix the link target
- Review warnings — fix if straightforward:
- Missing type-specific fields → fill them
- Date format issues → fix format
- Skeleton content → enrich further
- Note info items for tracking
Phase 4: Review (5 min per batch)¶
- Run
/vt-v-reviewon the completed batch - Classification:
- approve → Ready for commit
- revise → Domain agent can fix
- escalate-to-human → Flag for user review
- Fix revise items automatically
- Present escalation items to user
Phase 5: Commit¶
- Stage the batch:
git add vault/[DOMAIN]/... - Commit with descriptive message:
- Continue with next batch or finalize
Post-Sprint¶
- Run
/ims-audit --fullto calculate overall metrics - Generate sprint summary with metric deltas
- Present to user:
- Files processed
- Compliance-score change
- Items needing human review
- Recommended focus for next sprint
- Push branch and create PR (if user approves)
Domain Routing Table¶
| management_system value | Agent | Typical file types |
|---|---|---|
| ISMS | isms-expert | Controls (ISO 27001, VDA ISA, NIS2), incidents, security processes |
| DSMS | dsms-expert | VVT, TOM, DSFA, Datenpannen |
| QMS | qms-ims-expert | ISO 9001 controls, quality KPIs, training |
| IMS | qms-ims-expert | Policies, audits, mgmt review, suppliers, Umwelt |
Batch Size Guidelines¶
| Scenario | Batch Size | Reason |
|---|---|---|
| Controls (same norm) | 20-30 | Repetitive structure, efficient |
| VVT entries | 5-10 | Each requires supplier research |
| TOM checklists | 10-15 | Table-based, moderate complexity |
| Policies | 3-5 | Long documents, high complexity |
| Management review | 1 | Complex aggregation document |