worclaude 1.0.0

package/templates/spec-md-frontend.md

@@ -0,0 +1,81 @@
+# SPEC.md — {project_name}
+
+## Product Overview
+{description}
+
+## Tech Stack
+| Layer            | Technology                        |
+|------------------|-----------------------------------|
+| Language         | {tech_stack_table}                |{docker_row}
+| State Management | [e.g. Zustand, Redux, Pinia]     |
+| Styling          | [e.g. Tailwind, CSS Modules]     |
+| Build Tool       | [e.g. Vite, Webpack, Turbopack]  |
+| Testing          | [e.g. Vitest, Playwright]        |
+| Deployment       | [e.g. Vercel, Netlify, S3+CF]    |
+
+## Pages / Routes
+| Path              | Component        | Purpose                          |
+|-------------------|------------------|----------------------------------|
+| `/`               | HomePage         | [Landing or main entry point]    |
+| `/login`          | LoginPage        | [User authentication]            |
+| `/dashboard`      | DashboardPage    | [Primary authenticated view]     |
+| `/[resource]`     | [Resource]List   | [Browse/search items]            |
+| `/[resource]/:id` | [Resource]Detail | [View single item]               |
+| `/settings`       | SettingsPage     | [User preferences]               |
+| [add routes...]   | [Component]      | [Purpose]                        |
+
+## Component Architecture
+```
+App -> Layout (Navbar, Sidebar, Footer)
+    -> Pages -> [PageName] -> [FeatureSection] -> [Subcomponent]
+    -> Shared (Button, Input, Modal, Card, ...)
+```
+[Describe organization strategy: feature-based folders, atomic design, or flat]
+
+## State Management
+- **Global state:** [What lives in the global store — auth, theme, notifications]
+- **Server state:** [How API data is cached — React Query, SWR, or manual]
+- **Local state:** [Component-level state approach]
+- **URL state:** [What is stored in query params — filters, pagination, tabs]
+
+## Design System
+| Token         | Value                              |
+|---------------|------------------------------------|
+| Primary color | [e.g. #3B82F6]                    |
+| Font family   | [e.g. Inter, system-ui]           |
+| Base spacing  | [e.g. 4px grid]                   |
+| Border radius | [e.g. 8px default]                |
+| Breakpoints   | [sm:640, md:768, lg:1024, xl:1280]|
+
+- **Dark mode:** [Yes/No — implementation approach]
+- **Accessibility:** [WCAG level target, e.g. AA]
+- **Animations:** [Library or CSS transitions, motion-reduce support]
+
+## API Integration
+- **Base URL:** [e.g. `/api` or `https://api.example.com`]
+- **Auth header:** [e.g. `Authorization: Bearer <token>`]
+- **Error display:** [Toast notifications / inline errors / error pages]
+- **Optimistic updates:** [Which actions, if any]
+- **Offline support:** [Yes/No — strategy if yes]
+
+## Implementation Phases
+
+### Phase 1 — Foundation
+- [ ] Project scaffolding with build tool
+- [ ] Routing and layout shell
+- [ ] Design tokens and global styles
+- [ ] Shared UI components (Button, Input, Card, Modal)
+
+### Phase 2 — Core Pages
+- [ ] Authentication flow (login, signup, password reset)
+- [ ] [Primary feature] page with data fetching
+- [ ] [Secondary feature] page
+- [ ] Navigation and breadcrumbs
+
+### Phase 3 — Interactivity & Polish
+- [ ] Forms with validation
+- [ ] Search, filtering, and pagination
+- [ ] Real-time updates and file uploads [if applicable]
+- [ ] Responsive design, loading skeletons, error boundaries
+- [ ] Accessibility audit and performance optimization
+- [ ] E2E tests for critical user flows

package/templates/spec-md-fullstack.md

@@ -0,0 +1,81 @@
+# SPEC.md — {project_name}
+
+## Product Overview
+{description}
+
+## Tech Stack
+| Layer       | Technology                        |
+|-------------|-----------------------------------|
+| Language    | {tech_stack_table}                |{docker_row}
+| Backend     | [Framework, e.g. Express, Django] |
+| Database    | [e.g. PostgreSQL, MongoDB]        |
+| Auth        | [e.g. JWT, OAuth2, session-based] |
+| Hosting     | [e.g. Vercel, AWS, Railway]       |
+| CI/CD       | [e.g. GitHub Actions]             |
+
+## Pages / Routes
+| Path            | Page/Component   | Purpose                          | Auth Required |
+|-----------------|------------------|----------------------------------|---------------|
+| `/`             | Home             | [Landing page / dashboard]       | No            |
+| `/login`        | Login            | [User authentication]            | No            |
+| `/dashboard`    | Dashboard        | [Main authenticated view]        | Yes           |
+| [add routes...] | [ComponentName]  | [What the user accomplishes]     | [Yes/No]      |
+
+## API Endpoints
+| Method | Path               | Purpose                          | Auth Required |
+|--------|--------------------|----------------------------------|---------------|
+| POST   | `/api/auth/login`  | [Authenticate user]              | No            |
+| GET    | `/api/users/me`    | [Get current user profile]       | Yes           |
+| GET    | `/api/[resource]`  | [List resources]                 | [Yes/No]      |
+| POST   | `/api/[resource]`  | [Create resource]                | [Yes/No]      |
+| PUT    | `/api/[resource]/:id` | [Update resource]             | [Yes/No]      |
+| DELETE | `/api/[resource]/:id` | [Delete resource]             | [Yes/No]      |
+
+## Data Model
+### [PrimaryEntity]
+| Field       | Type      | Constraints                      |
+|-------------|-----------|----------------------------------|
+| id          | UUID      | Primary key, auto-generated      |
+| [field]     | [type]    | [required, unique, default, etc] |
+| created_at  | Timestamp | Auto-set on creation             |
+| updated_at  | Timestamp | Auto-set on update               |
+
+### [SecondaryEntity]
+| Field       | Type      | Constraints                      |
+|-------------|-----------|----------------------------------|
+| id          | UUID      | Primary key, auto-generated      |
+| [field]     | [type]    | [constraints]                    |
+| [foreign]   | UUID      | FK -> [PrimaryEntity].id         |
+
+## Authentication & Authorization
+- **Method:** [JWT tokens / session cookies / OAuth2 provider]
+- **Roles:** [e.g. admin, user, guest — describe what each can do]
+- **Token storage:** [httpOnly cookie / localStorage — justify choice]
+- **Session duration:** [e.g. 24h access token, 7d refresh token]
+
+## Implementation Phases
+
+### Phase 1 — Foundation
+- [ ] Project scaffolding and dev environment
+- [ ] Database schema and migrations
+- [ ] Basic authentication flow (signup, login, logout)
+- [ ] CI/CD pipeline
+
+### Phase 2 — Frontend Shell
+- [ ] Layout components (navbar, sidebar, footer)
+- [ ] Routing and navigation
+- [ ] Auth pages (login, signup, forgot password)
+- [ ] Design system / component library setup
+
+### Phase 3 — Backend Core
+- [ ] CRUD endpoints for [primary resource]
+- [ ] Input validation and error handling
+- [ ] Authorization middleware
+- [ ] [Additional domain logic]
+
+### Phase 4 — Integration & Polish
+- [ ] Connect frontend to backend APIs
+- [ ] Real-time features, file uploads, third-party integrations [if applicable]
+- [ ] Responsive design, loading states, error boundaries
+- [ ] Performance optimization (caching, lazy loading)
+- [ ] End-to-end tests, deployment, and monitoring setup

package/templates/spec-md-library.md

@@ -0,0 +1,87 @@
+# SPEC.md — {project_name}
+
+## Product Overview
+{description}
+
+## Tech Stack
+| Layer         | Technology                        |
+|---------------|-----------------------------------|
+| Language      | {tech_stack_table}                |{docker_row}
+| Build         | [e.g. tsup, rollup, setuptools]   |
+| Testing       | [e.g. Vitest, pytest, Jest]       |
+| Docs          | [e.g. TypeDoc, Sphinx, JSDoc]     |
+| Registry      | [e.g. npm, PyPI, crates.io]       |
+| CI/CD         | [e.g. GitHub Actions]             |
+
+## Public API
+[List all exports that form the public contract. Internal helpers should not appear here.]
+```
+[functionName](param: Type, options?: OptionsType): ReturnType
+  — [Description. Throws: ErrorType when condition]
+
+class [ClassName]
+  constructor(config: ConfigType)
+  [method](args): ReturnType    — [description]
+
+type [TypeName] = { [field]: Type; [field]?: Type }
+```
+
+## Configuration Options
+| Option        | Type     | Default    | Description                          |
+|---------------|----------|------------|--------------------------------------|
+| [option]      | string   | [default]  | [What it controls]                   |
+| [option]      | boolean  | `false`    | [When to enable]                     |
+| [option]      | number   | [default]  | [Valid range and effect]             |
+| [add more...] | [type]   | [default]  | [description]                        |
+
+## Usage Examples
+```[language]
+// Basic
+import { [functionName] } from '{project_name}';
+const result = [functionName]([exampleArgs]);
+
+// With configuration
+const instance = new [ClassName]({ /* [options] */ });
+const output = instance.[method]([args]);
+
+// Error handling
+try { [functionName]([invalidArgs]); }
+catch (error) { /* [ErrorType]: [message] */ }
+```
+
+## Compatibility Matrix
+| Runtime/Version        | Supported | Notes                      |
+|------------------------|-----------|----------------------------|
+| [Node.js >= 18]       | Yes       | [ESM and CJS]             |
+| [Node.js 16]          | No        | [Reason]                   |
+| [Python >= 3.10]      | Yes       | [Type hints required]      |
+| [Browser (ESM)]       | Yes       | [Bundle size: ~N kB gzip]  |
+| [add environments...] | [Yes/No]  | [notes]                    |
+
+- **Module formats:** [ESM, CJS, UMD — which are shipped]
+- **Type definitions:** [Bundled .d.ts / inline / separate package]
+- **Peer dependencies:** [List any, with version ranges]
+
+## Implementation Phases
+
+### Phase 1 — Foundation
+- [ ] Project scaffolding and build pipeline
+- [ ] TypeScript / type setup and strict config
+- [ ] Core function: [primary export]
+- [ ] Unit tests for core function
+- [ ] CI pipeline (lint, test, build)
+
+### Phase 2 — Core API
+- [ ] Remaining public functions and classes
+- [ ] Configuration and options handling
+- [ ] Error types and validation
+- [ ] Comprehensive test coverage (>90%)
+- [ ] JSDoc / docstrings for all exports
+
+### Phase 3 — Distribution
+- [ ] Bundle optimization (tree-shaking, size budget)
+- [ ] Generated API documentation
+- [ ] README with usage examples
+- [ ] CHANGELOG setup (conventional commits)
+- [ ] Publish to registry (npm/PyPI)
+- [ ] Integration tests with real consumers

package/templates/spec-md.md

@@ -0,0 +1,22 @@
+# SPEC.md — {project_name}
+
+## Product Overview
+{description}
+
+## Core Features
+[Define your features here]
+
+## Technical Architecture
+[Describe your architecture]
+
+## API / Interface Design
+[Define interfaces]
+
+## Data Model
+[Define data structures]
+
+## Implementation Phases
+[Break work into phases]
+
+## Design Decisions
+[Document key decisions and rationale]

package/templates/workflow-meta.json

@@ -0,0 +1,10 @@
+{
+  "version": "{version}",
+  "installedAt": "{timestamp}",
+  "lastUpdated": "{timestamp}",
+  "projectTypes": [],
+  "techStack": "",
+  "universalAgents": [],
+  "optionalAgents": [],
+  "fileHashes": {}
+}