docs: add Strangler Fig migration skill for Python extraction#466
docs: add Strangler Fig migration skill for Python extraction#466torlando-tech merged 1 commit intomainfrom
Conversation
…action Track the 9-phase plan to extract ~4,380 lines of business logic from reticulum_wrapper.py (8,032 lines) into Kotlin, leaving a thin ~250-400 line Python API for raw RNS/LXMF operations. The skill file gives future Claude sessions automatic awareness of the migration plan, phase dependencies, thin API surface, and anti-patterns. Also un-ignores .claude/skills/ in .gitignore so skills can be version-controlled while the rest of .claude/ stays ignored. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
bdede17 to
0474aa0
Compare
Greptile SummaryAdds a comprehensive Claude Code skill documenting the Strangler Fig migration strategy to extract ~4,380 lines of business logic from Key changes:
Confidence Score: 5/5
Important Files Changed
Last reviewed commit: 0474aa0 |
Codecov Report✅ All modified and coverable lines are covered by tests. 📢 Thoughts on this report? Let us know! |
| .claude/* | ||
| !.claude/skills/ | ||
| .claude/skills/* | ||
| !.claude/skills/columba-python-migration/ |
There was a problem hiding this comment.
Bug: The current .gitignore pattern will cause new files in the .claude/skills/columba-python-migration/ directory to be silently ignored by git.
Severity: MEDIUM
Suggested Fix
To ensure future files within the skill directory are tracked, add !.claude/skills/columba-python-migration/** to the .gitignore file. This will correctly un-ignore the directory and all of its contents.
Prompt for AI Agent
Review the code at the location below. A potential bug has been identified by an AI
agent.
Verify if this is a real issue. If it is, propose a fix; if not, explain why it's not
valid.
Location: .gitignore#L106-L109
Potential issue: The `.gitignore` rules are configured incorrectly. The pattern
`.claude/skills/*` ignores all contents within the `.claude/skills/` directory. The
subsequent negation `!.claude/skills/columba-python-migration/` only un-ignores the
directory itself, not its contents. As a result, any new files added to the
`.claude/skills/columba-python-migration/` directory in the future will be silently
ignored by git, which contradicts the pull request's goal of version-controlling skill
files.
Did we get this right? 👍 / 👎 to inform future reviews.
Summary
.claude/skills/columba-python-migration/SKILL.md— a Claude Code skill that gives future sessions automatic awareness of the 9-phase plan to extract ~4,380 lines of business logic fromreticulum_wrapper.pyinto Kotlin.claude/skills/in.gitignoreso skills can be version-controlled (rest of.claude/stays ignored)No code changes — documentation only.
Context
reticulum_wrapper.pyis 8,032 lines. ~70% is business logic (delivery state machines, telemetry, health monitoring, RMSP, event routing) that only needs to call RNS/LXMF APIs. The Strangler Fig migration will create a thin Python API (~250-400 lines) and move all orchestration to testable Kotlin, phase by phase, without touching the existing wrapper until final cleanup.Test plan
.claude/skills/columba-python-migration/SKILL.mdcontains no PII.claude/files (settings, memory.db, etc.) remain gitignored🤖 Generated with Claude Code