MicroFish/.claude/onboarding/step0_preparation/01_code_conventions.md

Step 0 — Code Conventions & Rules

Documentation of the rules and code conventions configured during the Claude Code workspace setup (Step 0).

Context

• Project: MiroFish — Multi-Agent Swarm Intelligence Prediction Engine
• Stack: Python (Flask, uv) backend + Vue 3 / Vite frontend
• Date applied: 2026-05-06

What Was Configured

1. .claude/settings.json — Permissions

Always allow (bash):

• cd:*
• ls:*
• find:*
• cat:*
• mkdir:*

Always deny (Read / Write / Edit):

• */.env*
• */secrets/*

Always deny (bash):

• rm -f*
• rm -rf*
• git push -f*
• git push --force*

This protects secrets and forbids destructive Git / filesystem operations while allowing safe navigation and inspection commands.

2. .claude/rules/ — Rule Files

File	Purpose
markdown.md	Adhere to standard Markdown syntax (markdownguide.org).
file-paths.md	Always wrap file paths in quotes; use a generic placeholder path in docs/examples.
commits.md	Conventional Commits standard; never add Co-Authored-By: watermarks.
error-handling.md	When an error occurs, offer to save it as a rule.
dev-guidelines.md	Salestech Products Development Guidelines (live source on Notion).

3. Salestech Development Guidelines

• Notion source (authoritative): https://candylabs.notion.site/development-guidelines
• A summary snapshot is stored in .claude/rules/dev-guidelines.md.
• Always consult the live document via the Notion MCP server for the latest version.
• Snapshot covers: formatting & style, naming, comments, Git workflow, React & TypeScript, Tailwind 4, folder structure, accessibility, environments / secrets / dependencies, security, infrastructure, enforcement.

4. Commit Watermarks

• Co-Authored-By: blocks must never be added to commits (matches §4.2 of the dev guidelines: "Avoid 'watermarks' like 'co-authored by Claude'").

Manual Setup Items (Not Automated)

The following items in Step 0 are user / environment setup and are not performed by this onboarding pass — they must be completed by the developer:

1. Claude Code clients
   • Claude Desktop, Claude Code CLI, VSCode extension
2. MCP servers (run from terminal, not from inside Claude)
   • Notion: claude mcp add --transport http notion https://mcp.notion.com/mcp
   • Atlassian: claude mcp add --transport http atlassian https://mcp.atlassian.com/v1/mcp
   • Figma: claude mcp add --transport http figma-remote-mcp https://mcp.figma.com/mcp
   • Authenticate each via /mcp in Claude after restart.
3. Basics
   • Node.js (https://nodejs.org/en) — required for CC-SDD.
   • Git + GitHub CLI (gh auth login) — required for PRs.

Next

• Step 1: Prepare the codebase (CLAUDE.md, README.md, structure)