CLAUDE.md

Claude Code Instructions

For Claude Code. This file points to the centralized documentation in .agent/.

---

Documentation Location

All agent documentation is centralized in the .agent/ directory.

Start here: .agent/readme.md

---

Quick Reference

System Documentation

• Architecture — Electron/React architecture, IPC patterns
• API Endpoints — cardano-wallet REST API
• State Management — MobX stores and patterns

Workflows

• /build — Nix shells and Yarn builds
• /test — Jest and Cucumber testing
• /electron — Electron main process development
• /frontend — React/MobX development
• /hardware-wallets — Ledger/Trezor development
• /ipc — IPC channel development
• /nix — Nix environment setup
• /storybook — Storybook component development
• /update-doc — Update documentation

Learning Resources

• Task History — Past implementation plans
• SOPs — Standard operating procedures
• Skills — Reusable task-specific playbooks (CLI, frontend, testing)

---

Common Commands

Development

yarn nix:mainnet          # Enter Nix shell (mainnet)
yarn nix:preprod          # Enter Nix shell (preprod testnet)
yarn dev                  # Start development mode

Building

yarn build                # Production build
yarn build:main           # Build main process only
yarn build:renderer       # Build renderer only
yarn package              # Create installer

Testing

yarn test:unit            # Cucumber unit tests
yarn test:e2e             # Cucumber E2E tests
yarn test:jest            # Jest tests
yarn storybook            # Component development

Code Quality

yarn lint                 # ESLint
yarn compile              # TypeScript check
yarn prettier:check       # Prettier check
yarn check:all            # Run all checks

---

Project Structure

daedalus/
├── .agent/                 # Agent documentation (READ THIS)
├── source/
│   ├── main/               # Electron main process
│   │   ├── cardano/        # Node/wallet management
│   │   ├── ipc/            # IPC handlers
│   │   ├── menus/          # Native menus
│   │   └── windows/        # Window management
│   ├── renderer/           # React UI
│   │   └── app/
│   │       ├── components/ # React components
│   │       ├── stores/     # MobX stores
│   │       ├── api/        # cardano-wallet client
│   │       ├── containers/ # Container components
│   │       └── i18n/       # Internationalization
│   └── common/             # Shared code
│       ├── ipc/            # IPC API contracts
│       └── types/          # TypeScript types
├── storybook/              # Component stories
├── tests/                  # Cucumber tests
├── installers/             # Platform installers
└── nix/                    # Nix configuration

---

Creating Documentation

When completing features or resolving issues:

1. Implementation plans → Save to .agent/plans/{domain}/
2. Resolved issues → Create SOP in .agent/SOPs/{category}/
3. New workflows → Add to .agent/workflows/

Run /update-doc workflow for guidance.