11 Commits

Author SHA1 Message Date
Leon van Zyl
0f8014f833 include technical details in implementation plan 2025-12-04 11:44:16 +02:00
Leon van Zyl
732744802a refactor: change GitHub workflow from task-level to phase-level issues
Update the feature workflow commands to create GitHub issues per phase
instead of per individual task. This reduces issue clutter while still
maintaining granular task tracking via checklists within phase issues.

Key changes:

**publish-to-github.md:**
- Create phase issues instead of individual task issues
- Each phase issue contains the full task checklist from implementation plan
- Add support for `[complex]` marker to break out complex tasks as separate issues
- Update Epic to link to phase issues instead of tasks
- Update github.md template to show phases and optional complex task issues

**create-feature.md:**
- Add documentation for `[complex]` task marker
- Update implementation plan format example with nested sub-tasks
- Add "When to Use [complex]" guidance section

**continue-feature.md:**
- Rewrite workflow to work with phase issues instead of task issues
- Add logic to identify current phase and find unchecked tasks
- Support both phase issue tasks and complex task issues
- Add step to update phase issue checklist after completing tasks
- Update completion reporting for phase-based progress
- Renumber steps (8.x → 7.x) for consistency

**Hybrid approach:**
- Default: one issue per phase with task checklists
- Optional: break out tasks marked `[complex]` or with nested sub-tasks
- Complex task issues link back to parent phase issue

This change results in ~5 issues (1 epic + 4 phases) instead of ~47 issues
for a typical feature, significantly reducing GitHub issue noise.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-12-03 14:23:35 +02:00
Leon van Zyl
9332df2253 feat: add action-required.md to /create-feature command
Extends the /create-feature command to generate a third file that
extracts manual/human tasks into a dedicated checklist for better
visibility.

Changes:
- Add step 4 to create action-required.md with manual tasks
- Add template format with Before/During/After Implementation sections
- Add "no manual steps" template variant
- Update Next Steps to prioritize reviewing action-required.md
- Add note listing common manual task types (API keys, env vars, etc.)
- Bump create-agentic-app version to 1.1.27

Manual tasks (like account creation, environment variables, OAuth setup)
are now surfaced in a separate file so they're harder to miss during
feature implementation.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-12-03 12:23:07 +02:00
Leon van Zyl
90b8a286da add GitHub-integrated feature workflow commands and bump version to 1.1.25
This commit introduces a comprehensive feature management workflow that
integrates with GitHub Issues and Projects for better task tracking and
team collaboration.

## New Commands Added

- `/publish-to-github`: Publishes features from /specs to GitHub by:
  - Creating an Epic issue with full requirements
  - Creating individual task issues for each implementation step
  - Setting up a GitHub Project board linked to the repository
  - Creating labels for organization (epic, feature/*, phase-*)
  - Generating a github.md reference file in the specs folder

- `/continue-feature`: Implements the next available task by:
  - Querying open issues for the feature
  - Checking task dependencies to find unblocked work
  - Updating GitHub Project board status (In Progress -> Done)
  - Adding implementation details as issue comments
  - Providing fallback to implementation-plan.md when offline

## Updated Commands

- `/create-feature`: Enhanced with clearer structure including:
  - Detailed implementation plan format template
  - Requirements for atomic, agent-implementable tasks
  - Guidance on next steps after feature creation
  - Better documentation for the /specs folder structure

## Package Updates

- Bumped version from 1.1.24 to 1.1.25

All changes are mirrored in both the root .claude/commands/ folder
and the create-agentic-app/template/.claude/commands/ folder to ensure
new projects created with the CLI have access to these workflows.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-12-03 07:05:26 +02:00
Leon van Zyl
a3a151c67a feat: comprehensive boilerplate improvements
Security & Stability:
- Add Next.js 16 proxy.ts for BetterAuth cookie-based auth protection
- Add rate limiting for API routes (src/lib/rate-limit.ts)
- Add Zod validation for chat API request bodies
- Add session auth check to chat and diagnostics endpoints
- Add security headers in next.config.ts (CSP, X-Frame-Options, etc.)
- Add file upload validation and sanitization in storage.ts

Core UX Components:
- Add error boundaries (error.tsx, not-found.tsx, chat/error.tsx)
- Add loading states (skeleton.tsx, spinner.tsx, loading.tsx files)
- Add toast notifications with Sonner
- Add form components (input.tsx, textarea.tsx, label.tsx)
- Add database indexes for performance (schema.ts)
- Enhance chat UX: timestamps, copy-to-clipboard, thinking indicator,
  error display, localStorage message persistence

Polish & Accessibility:
- Add Open Graph and Twitter card metadata
- Add JSON-LD structured data for SEO
- Add sitemap.ts, robots.ts, manifest.ts
- Add skip-to-content link and ARIA labels in site-header
- Enable profile page quick action buttons with dialogs
- Update Next.js 15 references to Next.js 16

Developer Experience:
- Add GitHub Actions CI workflow (lint, typecheck, build)
- Add Prettier configuration (.prettierrc, .prettierignore)
- Add .nvmrc pinning Node 20
- Add ESLint rules: import/order, react-hooks/exhaustive-deps
- Add stricter TypeScript settings (exactOptionalPropertyTypes,
  noImplicitOverride)
- Add interactive setup script (scripts/setup.ts)
- Add session utility functions (src/lib/session.ts)

All changes mirrored to create-agentic-app/template/

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-30 14:46:15 +02:00
Leon van Zyl
db09a4fff8 update npmjs version 2025-11-30 07:29:51 +02:00
Marcos Fernandez
b73ef9e345 fix: remove hardcoded Windows path from Claude settings
Remove platform-specific Windows path from additionalDirectories in Claude settings files to ensure cross-platform compatibility across Windows, macOS, and Linux.
2025-11-17 06:53:30 -08:00
Leon van Zyl
04958f1357 refactor: rename ui-developer agent to ui-expert and bump version
Renamed the ui-developer agent to ui-expert for better clarity and
consistency with naming conventions. This change affects both the root
project and the create-agentic-app template.

Changes made:
- Renamed .claude/agents/ui-developer.md to ui-expert.md in both root and template
- Updated agent name and references within agent configuration
- Bumped create-agentic-app version from 1.1.14 to 1.1.15
- Updated corresponding package-lock.json with new version

The agent's functionality and responsibilities remain unchanged - this is
purely a naming improvement to better reflect its role as a UI expert
rather than just a developer.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-17 09:36:04 +02:00
Leon van Zyl
4b70e6ba33 clean up commands 2025-11-08 11:50:43 +02:00
Leon van Zyl
bd74276feb fix/ remove container name from docker compose 2025-11-06 07:17:58 +02:00
Leon van Zyl
ec929ab918 npx command 2025-11-02 08:45:37 +02:00