Initial commit: Server configurations and license management
This commit is contained in:
303
docs/CLAUDE-ASSISTANT.md
Normal file
303
docs/CLAUDE-ASSISTANT.md
Normal file
@@ -0,0 +1,303 @@
|
||||
# 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
|
||||
Reference in New Issue
Block a user