flowmade-one/architecture
3
0
Fork 0
Code Issues 20 Pull Requests 1 Actions Packages Projects Releases Wiki Activity

Reduce duplication between software-architecture.md and skill #70

New Issue
Closed
opened 2026-01-10 14:10:21 +00:00 by HugoNijhuis · 0 comments
HugoNijhuis commented 2026-01-10 14:10:21 +00:00
Owner
Copy Link
Copy Source

Summary

software-architecture.md (repo root) and skills/software-architecture/SKILL.md contain nearly identical content. While the root file notes this is intentional, it creates maintenance burden.

Current State

  • Root file has a note: "For Claude: This content is mirrored in skills/..."
  • Both files contain the same beliefs→patterns mapping
  • Changes must be made in two places

Options

  1. Keep root as canonical, skill as Claude-specific - Skill contains only what differs
  2. Remove root file - Skill is the single source of truth
  3. Accept duplication - Document the maintenance requirement

Acceptance Criteria

  • Decide on approach
  • Implement chosen solution
  • Update any references

Context

From /arch-review-repo finding. Priority: P2 - Medium.

## Summary `software-architecture.md` (repo root) and `skills/software-architecture/SKILL.md` contain nearly identical content. While the root file notes this is intentional, it creates maintenance burden. ## Current State - Root file has a note: "For Claude: This content is mirrored in skills/..." - Both files contain the same beliefs→patterns mapping - Changes must be made in two places ## Options 1. **Keep root as canonical, skill as Claude-specific** - Skill contains only what differs 2. **Remove root file** - Skill is the single source of truth 3. **Accept duplication** - Document the maintenance requirement ## Acceptance Criteria - [ ] Decide on approach - [ ] Implement chosen solution - [ ] Update any references ## Context From `/arch-review-repo` finding. Priority: P2 - Medium.
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
No items
No labels
Milestone
No items
No Milestone
Projects
Clear projects
No projects
Assignees
Clear assignees
HugoNijhuis (Hugo Nijhuis) fluxcd-bot renovate-bot
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: flowmade-one/architecture#70