Using Claude for Specifications

Använda Claude för specifikationer / Using Claude for Specifications

Claude Desktop can help you brainstorm, structure, and write feature specifications.

Setup / Installation

1. Install Claude Desktop

Download from claude.ai/download and sign in with your account.

2. Open Your Workspace

In Claude Desktop, open the vulcan-workspace folder so Claude has access to context files.

Providing Context / Ge kontext

For best results, reference the product context files:

Read these files for context:
- repos/vulcan-docs/docs/product/context/vision.md
- repos/vulcan-docs/docs/product/context/modules.md
- repos/vulcan-docs/docs/product/context/personas.md
- repos/vulcan-docs/docs/product/context/workflows.md

Example Prompts / Exempelfrågor

Brainstorming a Feature

I want to improve how administrators track lead status.
Based on the Lead CRM module in modules.md,
what features would help with this?

Structuring a Spec

I have an idea for a feature: [describe your idea]

Help me structure this into a feature specification
using the template in templates/feature-spec.md

Writing in Swedish

Hjälp mig skriva en specifikation för [funktion].
Använd mallen i templates/feature-spec.md.
Jag vill skriva på svenska.

Translating Terms

What's the English term for "arbetspaket"?
Check the glossary at resources/glossary.md

Validating Against Vision

Does this feature align with Vulcan's product vision?
Check against context/vision.md

Workflow / Arbetsflöde

1. Start with the Problem

I'm trying to solve this problem: [problem description]
Who experiences this problem? (Administrator/Craftsman/Customer)

2. Generate Ideas

What are some ways to solve this problem
within the [module name] module?

3. Draft the Spec

Based on our discussion, create a feature spec
using the template. Include:
- Problem statement
- User stories for affected personas
- Acceptance criteria

4. Review and Refine

Review this spec against the product vision.
Are there any gaps or inconsistencies?

Tips / Tips

Do / Gör

• Provide context files for better responses
• Be specific about the problem you're solving
• Ask Claude to use the templates
• Request Swedish or English as needed

Don't / Gör inte

• Expect Claude to know Vulcan specifics without context
• Accept the first draft without review
• Skip the problem statement

Example Session / Exempelsession

You: I need to create a spec for a feature that lets
     customers see their project progress online.

Claude: I'll help you create that spec. First, let me
        understand the context...

        Based on the Customer portal feature in modules.md
        and the Customer persona in personas.md, here's
        a draft specification...

You: That looks good. Can you add acceptance criteria
     using Given/When/Then format?

Claude: Here are the acceptance criteria...

Saving Your Work / Spara ditt arbete

Once you're happy with the spec:

1. Copy the content
2. Create a new file: docs/product/specs/your-feature-name.md
3. Paste and save
4. Follow the Submitting Guide