Wiki Sync & Mandatory Files
Mandatory Files (enforced by npx spexso init)
| File | Created by | Updated by | Purpose |
|---|---|---|---|
README.md | npx spexso init (template) | Developer manually | Project overview, setup instructions, architecture summary |
CHANGELOG.md | npx spexso init (empty) | /spexso-finish auto-appends | Auto-updated with each MR's title, date, and issue link |
CLAUDE.md | npx spexso init (appends section) | Developer + tech lead | Project conventions for Claude Code |
docs/adr/ | npx spexso init (directory) | /spexso-docs adr | Architecture Decision Records |
/spexso-docs Usage
bash
# Create a new Architecture Decision Record
/spexso-docs adr Switch from REST to GraphQL for the dashboard API
# -> Creates docs/adr/ADR-003-switch-to-graphql.md with structured template
# -> Pushes to GitLab wiki under "Architecture Decisions" section
# Sync all docs to wiki
/spexso-docs sync
# -> Pushes all docs/adr/*.md to wiki
# -> Pushes all docs/research/*.md (from /spexso-tinder) to wiki
# Update changelog (normally auto-done by /spexso-finish)
/spexso-docs changelog Manual entry: migrated auth to XSUAA v3CHANGELOG.md Auto-Update Format
Appended by /spexso-finish:
markdown
## [2026-04-01] Issue #42 — Leave request approval workflow
- MR !17 merged by @dev-a
- Type: feature | Size: M | Mode: pilot
- Files changed: 8 | Tests added: 12 | Review: 2 high auto-fixed, 3 low comments