Repository Type: GitHub Profile README
Owner: ryu (ryugen-io)
Purpose: Personal profile showcasing AI/MCP technology stack and projects
Primary File:
README.md
This is a documentation-only repository containing a GitHub profile README. It has no source code, dependencies, or build systems.
ryugen-io/
├── README.md # GitHub profile README (main content)
├── CLAUDE.md # This file - AI assistant guide
└── .git/ # Git repository metadata
- Total Files: 2 (README.md, CLAUDE.md)
- Languages: None (documentation only)
- Dependencies: None
- Build System: None
- CI/CD: None
The README.md serves as a GitHub profile page and follows these conventions:
-
Tone & Style
- Personal and casual
- Direct and concise
- Tech-focused without excessive marketing language
- No emojis (removed in commit bd21aaa)
-
Structure
- Opening greeting with author name
- Brief mission statement
- Technology stack with badge links
- Current focus/projects
- Contact information
-
Badge Format
- Uses shields.io badges
- Format:
[](link-url)
- Includes logo and color customization
- Current badges:
- Anthropic Claude (purple: #6C47FF)
- MCP Protocol (orange)
- Rust (orange with logo)
-
Technology Stack Display
- Lists current working technologies
- Links to official project pages
- Highlights specific tools (e.g., "Serena MCP")
- Includes version years for languages (e.g., "Rust 2024")
Based on commit history:
- Avoid: Excessive emojis (see commit bd21aaa: "Remove emojis from profile")
- Prefer: Clean, text-based formatting with shields.io badges
- Focus: AI development, MCP protocol, Rust, automation
- Style: Straightforward descriptions over hype
- Main Branch:
main
(not specified in git config, likely default)
- Feature Branches: Use
claude/
prefix for AI assistant work
- Format:
claude/claude-md-<session-id>
- Example:
claude/claude-md-mi0pusm9opq9vai9-019otrda3WNHiQrWWtS66Tpg
Based on existing commit history:
Pattern: <Action> <subject> [with <detail>]
Examples:
✓ "Update README with MCP and AI buddy details"
✓ "Remove emojis from profile"
✓ "Add profile README with AI/MCP stack"
Guidelines:
- Use imperative mood ("Add", "Update", "Remove")
- Be specific about what changed
- Include "why" context when helpful
- Keep under 72 characters when possible
-
Before Editing
- Read README.md to understand current state
- Check git log for recent changes and patterns
- Verify current branch with
git status
-
When Editing README.md
- Maintain existing structure
- Follow badge format conventions
- Keep tone consistent (personal, tech-focused)
- No emojis unless explicitly requested
- Ensure all links are valid and relevant
-
Committing
git add <files>
git commit -m "Clear, descriptive message"
git push -u origin <branch-name>
-
Push Requirements
- Use
git push -u origin <branch-name>
- Branch must start with
claude/
for AI assistant work
- Retry up to 4 times with exponential backoff if network issues
When updating the "Currently working with" section:
-
Maintain badge format:
[](https://link-url)
-
Keep badges grouped logically
-
Update description text to match
-
Verify all URLs are accessible
When adding new project mentions:
- Link to official project pages
- Use bold for emphasis on key tools
- Keep descriptions brief (one line preferred)
- Maintain consistent formatting with existing entries
When refreshing outdated content:
- Check if technology versions need updating (e.g., "Rust 2024" → "Rust 2025")
- Verify all external links still work
- Remove deprecated tools or outdated references
- Update badge colors if branding has changed
When fixing formatting issues:
- Ensure consistent spacing (blank lines between sections)
- Check badge syntax is correct
- Verify Markdown rendering (headings, links, lists)
- Remove any accidental emoji additions
- AI Platform: Claude (Anthropic) - Opus model
- Protocol: MCP (Model Context Protocol)
- Language: Rust (2024 edition)
- MCP Server: Serena MCP (https://github.com/cristianvogel/serena)
- Line Count: ~20 lines
- Last Updated: Nov 10, 2025 (commit f09d204)
- Encoding: UTF-8
- Line Endings: LF (Unix-style)
- Max Line Length: ~120 characters (badge lines)
Recent Changes:
- f09d204: Added Serena MCP and Claude Opus details
- bd21aaa: Removed emojis for cleaner appearance
- 5533901: Initial creation with AI/MCP stack info
URL: http://[email protected]:19447/git/ryugen-io/ryugen-io
- File mode tracking: Enabled
- Ref update logging: Enabled
- Repository format version: 0
- ✓ Read README.md before making any changes
- ✓ Follow existing commit message patterns
- ✓ Maintain the current tone and style
- ✓ Use shields.io badges for technology references
- ✓ Keep content concise and focused
- ✓ Verify links before adding them
- ✓ Use
claude/
branch prefix for development
- ✓ Push with
-u origin <branch-name>
- ✗ Add emojis (they were intentionally removed)
- ✗ Make content overly promotional or marketing-heavy
- ✗ Add unnecessary files or directories
- ✗ Create build systems or dependencies (this is profile-only)
- ✗ Push to main without explicit permission
- ✗ Ignore existing formatting conventions
- ✗ Add large sections that break the concise nature
- Review git history:
git log --oneline
- Check existing content patterns in README.md
- Ask the user for clarification
- Maintain existing style over introducing new patterns
Solution: Ensure branch name starts with
claude/
and matches session ID format
Solution: Check URL encoding, verify shields.io syntax, test badge URL in browser
Solution: Ask user for specific requirements, review recent commits for context
| Date | Version | Changes |
|---|
| 2025-11-15 | 1.0 | Initial CLAUDE.md creation with comprehensive guidelines |
This repository is intentionally minimal. Its sole purpose is to serve as a GitHub profile README. There are no plans for:
- Source code additions
- Build systems or CI/CD
- Dependencies or package management
- Complex directory structures
- Automated testing
Any changes should focus on keeping the README.md accurate, current, and aligned with the owner's (ryu's) technology focus and personal brand.
Last Updated: 2025-11-15
Last Reviewed By: AI Assistant (Claude)
Next Review: As needed when significant profile updates occur