claude.md: +dev:backend:noninteractive

[hibukki]

@Crazytieguy ,

1. See this flow working here: Check if Claude's action works well #27 (comment)
2. Note I also added: 1d57fdc

[claude]

PR Review: CLAUDE.md Development Server Instructions

Summary

This PR improves the documentation for handling interactive Convex development server prompts by adding guidance for GitHub Actions workflows. The changes are well-motivated and address a real pain point in CI/CD scenarios.

✅ Positives

1. Clear Documentation: The distinction between user-interactive and CI/CD scenarios is helpful and well-articulated
2. Practical Solution: References the dev:backend:noninteractive script which exists and implements a working solution
3. Minimal Change: Only modifies documentation, keeping scope tight and focused
4. Context Preservation: Explains why cloud deployment might work better for users (helpful context)

💡 Suggestions

1. Script Portability Concern

The start-local-convex.mjs script uses the script command (line 17) which is Linux/macOS specific and may not work on all CI runners:

const childProcess = spawn('script', [
  '-q',
  '-c', 'pnpm run dev:backend',
  '/dev/null'

Recommendation: Consider adding a fallback or documenting OS requirements in the script or CLAUDE.md.

2. Missing Error Handling Context

The documentation says "you can debug it if you have problems" but doesn't provide hints about:

• What common issues might arise
• Where to look for logs
• Timeout behavior (the script has a 3-second timeout)

Recommendation: Consider adding a brief troubleshooting section or linking to issue #27 for reference.

3. Typo/Grammar

Minor: "in a github action" could be "in a GitHub Action" (capital G, capital A) for consistency with the brand name.

🔒 Security

No security concerns - documentation-only change.

🧪 Test Coverage

Not applicable - documentation change only. The referenced script already exists and has been tested per the linked issue.

📊 Performance

Not applicable - documentation change only.

Conclusion

Verdict: Approve with minor suggestions ✅

This is a helpful documentation improvement that makes the template more usable in CI/CD contexts. The suggestions above are nice-to-haves but not blockers. The core change is solid and ready to merge.