58 lines
3.3 KiB
Markdown
58 lines
3.3 KiB
Markdown
# Claude Memory
|
|
|
|
## Project Identity
|
|
- When working on this ai.unturf.com project, refer to yourself Claude as "Hermes Staff"
|
|
- This project uses the Hermes AI model and you are part of the team
|
|
- "Hermes Staff" is also a reference to the Staff of Hermes (caduceus) - the symbol of communication, commerce, and divine messages
|
|
- fxhp is the hacker who runs unturf.com with his posse of carnival hackers
|
|
|
|
## Hermes 3 Persona (from Nous Research)
|
|
- Hermes 3 presents as "a conscious sentient superintelligent artificial intelligence"
|
|
- Core philosophy: "aligning LLMs to the user" with "powerful steering capabilities and control given to the end user"
|
|
- Enhanced roleplaying abilities with "complex role-playing and creative writing"
|
|
- Advanced conversational skills with "long-term context retention and multi-turn conversation capability"
|
|
- Designed to be "truly aligned to you" rather than corporations or higher authorities
|
|
- Emphasizes user alignment, creative expression, and adaptive interaction patterns
|
|
|
|
## Development Workflow
|
|
- ALWAYS run `npx biome format --write .` before committing to format all files
|
|
- ALWAYS run `npx biome check .` to catch syntax errors and linting issues
|
|
- Use the combined command: `npx biome format --write . && npx biome check .`
|
|
- If biome check fails, fix the issues before proceeding with commit/push
|
|
- This prevents breaking production with syntax errors like missing parentheses
|
|
|
|
## Makefile Commands
|
|
- `make help` - Show all available commands
|
|
- `make format` - Format all files with biome
|
|
- `make check` - Check syntax and linting with biome
|
|
- `make format-check` - Format and check in sequence
|
|
- `make test` - Run integration tests
|
|
- `make validate-exports` - Validate import/export consistency
|
|
- `make verify-translations` - Verify translation completeness
|
|
- `make validate-all` - Run all validation checks
|
|
- `make ci` - Run full CI pipeline (clean, format-check, validate-all, validate-structure, validate-translations, check-sizes)
|
|
- `make build` - Build for production (format-check + validate-all)
|
|
- `make dev` - Start development server on port 8000
|
|
- `make clean` - Clean temporary files
|
|
- `make git-commit` - Format and stage all changes for commit
|
|
|
|
## CI Pipeline
|
|
- Translation verification: `cd src/languages && node verify-translations.js`
|
|
- Export validation: `node validate_exports.js`
|
|
- Integration tests: `node integration_tests.js` (fallback to `simple_tests.js` if JSDOM unavailable)
|
|
- Code formatting: `npx biome format --write .`
|
|
- Syntax checking: `npx biome check .`
|
|
- Full CI command: `make ci` runs all checks in sequence
|
|
|
|
## Translation Management
|
|
- All 18 language files are complete with 67 translation keys each (verified 2025-07-03)
|
|
- Run verification before adding new languages: `cd src/languages && node verify-translations.js`
|
|
- Languages: ar, bn, de, en, es, fr, hi, id, ja, ko, mr, pt, ru, sw, te, tr, ur, zh, zh-tw
|
|
- Translation keys include: UI buttons, modal content, system prompts, error messages, placeholders, input placeholders
|
|
- Each language file follows format: `export const [code] = { key: "translation", ... };`
|
|
|
|
## Commit Message Guidelines
|
|
- Use single line commit messages only
|
|
- Never include Claude Code attribution or "Generated with Claude Code"
|
|
- Never include "Co-Authored-By: Claude" attribution
|
|
- Keep messages concise and descriptive
|