Working with Claude Code

How it works

Every Myco app includes a CLAUDE.md file at the project root. This file teaches Claude Code how to use the Myco SDK, CLI, and project conventions. When you open Claude Code in your app directory, it reads this file automatically.

This means Claude already knows how to:

• Create and manage entities with the myco CLI
• Use the SDK hooks for data fetching and auth
• Build pages with shadcn/ui components
• Create API routes in the Worker
• Write and deploy skills for AI chat

Effective prompts

Here are examples of prompts that work well:

Adding a new feature

“Add a contacts page. Create a contact entity with name, email, phone, and company fields. Build a page that lists contacts in a table with add, edit, and delete.”

Claude will:

1. Run myco entity create to define the schema
2. Create a page component with SDK hooks
3. Add the route and sidebar navigation

Building CRUD

“Add the ability to create and edit tasks. Use a dialog form with title, priority dropdown, and a completed checkbox.”

Adding AI capabilities

“Create a skill that helps users search for contacts and draft emails. It should use the search-contacts and send-gmail-draft tools.”

Fixing issues

“The tasks page shows a loading spinner forever. Can you debug it?”

Tips for vibe coding

Be specific about UI

Instead of “make a nice page”, say “build a table with sortable columns, a search bar, and pagination.” Claude produces better results with concrete descriptions.

Let Claude handle the CLI

Don’t memorize CLI flags. Just describe what data you need: “create an entity for tracking invoices with amount, status, and due date.” Claude knows the right commands.

Iterate in small steps

Build one feature at a time. “Add a contacts list” → “add a form to create contacts” → “add inline editing” works better than one massive prompt.

Reference existing patterns

If your app already has a working page, say “build a projects page similar to the contacts page.” Claude picks up on existing patterns.

What Claude handles vs. what you do