Files
SERVtomaste/docs/CLAUDE-ASSISTANT.md

304 lines
9.1 KiB
Markdown

# Claude AI Professional Assistant
> **Status:** Operational
> **Last Updated:** November 28, 2025
> **Role:** Professional assistant for Atomaste consulting work
---
## Overview
Claude is your professional AI assistant for your mechanical/simulation freelance engineering work at **Atomaste**.
**Primary Functions:**
- **Day Planning** - Prepare priorities, tasks, reminders
- **Work Documentation** - Log activities, summarize accomplishments
- **Daily Notes** - Maintain comprehensive daily records
- **Project Tracking** - Monitor CAD work, commits, progress
- **Work-Life Balance** - Weather/outdoor activity planning
**Architecture:** MCP server on dalidou + Claude Code on Windows (free with subscription)
---
## Daily Workflow
### Morning - Start the Day
Say: **"Hey good morning, let's start my day"** or **"Bonjour, on commence?"**
Claude will:
1. **Review yesterday** - What was accomplished, commits made
2. **Check priorities** - Outstanding tasks, deadlines
3. **Plan today** - Suggest focus areas and time blocks
4. **Weather check** - Conditions for outdoor breaks (skiing, etc.)
5. **Set the tone** - Energizing briefing to start productive
### During the Day
- "What should I focus on next?"
- "Log this: finished FEA analysis for P04-Gigabit"
- "Remind me to follow up with client X"
- "Push my CAD work"
- "What have I done today so far?"
### Evening - Close the Day
Say: **"Let's wrap up the day"** or **"On ferme la journée"**
Claude will:
1. **Summarize work** - All commits, files changed, activities logged
2. **Document achievements** - What was completed
3. **Note blockers** - What's pending or stuck
4. **Plan tomorrow** - Suggested priorities for next day
5. **Update daily note** - Comprehensive record of the day
---
## What Claude Tracks
### Work Activities
- CAD file changes (NX Siemens, SolidWorks)
- Git commits with descriptions
- Project progress (P04-Gigabit, etc.)
- Client work and deliverables
- FEA/simulation tasks
### Daily Documentation
- Time spent on tasks
- Accomplishments and milestones
- Blockers and challenges
- Decisions made
- Ideas and notes
### Personal Balance
- Weather conditions
- Best outdoor activity windows
- Skiing conditions
- Work breaks and energy management
---
## Slash Commands
| Command | Description |
|---------|-------------|
| `/morning` | Full morning briefing with planning |
| `/eod` | End of day summary and documentation |
| `/ski` | Skiing conditions check |
| `/weather` | Quick weather check |
| `/push` | Push CAD changes to Gitea |
| `/pull` | Pull latest from Gitea |
---
## Natural Language Examples
### Planning
- "What are my priorities today?"
- "I need to focus on the P04 assembly this morning"
- "Block 2 hours for FEA work"
- "What's pending from yesterday?"
### Logging Work
- "Log: completed thermal analysis for client X"
- "I just finished the bracket redesign"
- "Note: waiting for client feedback on envelope design"
- "Add to today: reviewed simulation results, found stress concentration issue"
### Tracking Progress
- "What did I work on this week?"
- "Show me my recent commits"
- "How's the P04-Gigabit project going?"
- "What files did I modify today?"
### CAD Workflow
- "Push my CAD work" (with commit message)
- "Pull latest files"
- "What's changed in CADTOMASTE?"
### Breaks & Balance
- "When's good for skiing today?"
- "What's the weather like?"
- "Should I take a break outside?"
---
## Daily Note Structure
Claude maintains daily documentation with:
```markdown
# [Date] - Daily Work Log
## Morning Plan
- Priority 1: ...
- Priority 2: ...
- Scheduled: ...
## Work Log
- 09:00 - Started FEA analysis for P04-Gigabit
- 11:30 - Completed mesh refinement
- 14:00 - Client call regarding envelope specs
- ...
## Commits
- a57c45b: "Updated lateral support shoe geometry"
- 8624cdd: "Fixed mesh convergence issue"
## Accomplishments
- Completed thermal analysis
- Delivered preliminary results to client
- Fixed bracket interference issue
## Blockers / Pending
- Waiting for client approval on design change
- Need material data for simulation
## Notes & Ideas
- Consider alternative mounting approach
- Research vibration damping options
## Tomorrow's Focus
- Finalize P04 assembly
- Start documentation for deliverable
```
---
## MCP Tools Available
| Tool | Description |
|------|-------------|
| `get_current_weather` | Current conditions in Rouyn-Noranda |
| `get_hourly_forecast` | Hour-by-hour forecast |
| `get_daily_forecast` | Daily forecast (highs, lows) |
| `find_best_activity_windows` | Best times for skiing, hiking |
| `check_skiing_conditions` | Quick ski conditions check |
| `get_today_commits` | Today's git commits |
| `get_recent_activity` | Recent git activity (7 days) |
| `list_repos` | List Gitea repositories |
---
## Architecture
```
┌─────────────────────────────────────────────────────────────┐
│ DALIDOU SERVER (100.80.199.40) │
│ ┌───────────────────────────────────────────────────────┐ │
│ │ MCP Server (/srv/claude-assistant) │ │
│ │ ├─ Weather tools (Open-Meteo API) │ │
│ │ ├─ Gitea tools (commits, repos) │ │
│ │ └─ Activity analysis │ │
│ └───────────────────────────────────────────────────────┘ │
└─────────────────────────────────────────────────────────────┘
│ SSH + MCP Protocol
┌─────────────────────────────────────────────────────────────┐
│ WINDOWS WORKSTATION │
│ ┌───────────────────────────────────────────────────────┐ │
│ │ Claude Code (Opus 4.5 - your subscription) │ │
│ │ ├─ Intelligent planning and analysis │ │
│ │ ├─ Work documentation and logging │ │
│ │ ├─ CAD file management (push/pull) │ │
│ │ └─ Daily note maintenance │ │
│ └───────────────────────────────────────────────────────┘ │
└─────────────────────────────────────────────────────────────┘
```
---
## Configuration
### Server Location
```
/srv/claude-assistant/
├── .env # API keys and tokens
├── config.yaml # Location, preferences
├── run-mcp.sh # MCP startup script
├── mcp-server/
│ └── server.js # MCP server
└── tools/
├── weather.js # Open-Meteo integration
├── gitea.js # Gitea API
└── obsidian.js # Daily notes (future)
```
### Windows Configuration
```
C:\Users\Antoine\.claude\
├── mcp.json # MCP server connection
└── commands/
├── morning.md # Morning briefing
├── eod.md # End of day summary
├── ski.md # Skiing conditions
├── weather.md # Weather check
├── push.md # Push CAD
└── pull.md # Pull CAD
```
---
## Cost
| Usage | Cost |
|-------|------|
| Interactive (Claude Code) | **FREE** (your subscription) |
| Automated API (optional) | ~$0.03 per run |
Current setup = **$0/month**
---
## What's Working
- [x] MCP server on dalidou
- [x] Weather and skiing tools
- [x] Gitea integration (commits, repos)
- [x] Slash commands
- [x] Push/pull CAD workflow
- [x] Natural language interaction
---
## Future Improvements
- [ ] Daily notes auto-save to Obsidian vault
- [ ] Calendar integration (meetings, deadlines)
- [ ] Client project tracking
- [ ] Time tracking per project
- [ ] Weekly/monthly summaries
- [ ] Invoice preparation assistance
---
## Troubleshooting
### MCP not connecting
```bash
ssh root@100.80.199.40 /srv/claude-assistant/run-mcp.sh
```
Then restart VSCode.
### Gitea returns empty
Check token in `/srv/claude-assistant/.env`
### Check MCP status
```
claude mcp list
```
---
## Quick Start
1. Open Claude Code (VSCode)
2. Say "Hey good morning, let's start my day"
3. Claude prepares your briefing
4. Work on your projects
5. Say "Log: [what you did]" to track activities
6. End with "Let's wrap up the day"
7. Claude documents everything