schub 0.1.0

package/templates/create-tasks/task-template.md

@@ -0,0 +1,33 @@
+# Task: {{TASK_ID}} {{TASK_TITLE}}
+
+**Change ID**: [`{{CHANGE_ID}}`](../../changes/{{CHANGE_ID}}/proposal.md)  
+**Priority**: P1
+**Depends on**: [optional]  
+**Parallelizable**: [yes/no]
+
+## Goal
+
+[What this task accomplishes, in one paragraph.]
+
+## Scope
+
+### In Scope
+
+- [Included work]
+
+### Out of Scope
+
+- [Explicitly excluded work]
+
+## Steps
+
+- [ ] Step 1
+- [ ] Step 2
+- ...
+
+## Acceptance
+
+- [ ] [Objective 1 pass/fail condition]
+- [ ] [Objective 2 pass/fail condition]
+- [ ] [Objective 3 pass/fail condition]
+- ...

package/templates/review-proposal/q&a-template.md

@@ -0,0 +1,13 @@
+# Q&A {{CHANGE_TITLE}}
+
+**Change ID**: `{{CHANGE_ID}}`  
+**Created**: {{DATE}}
+
+### ❓ <Question 1>
+**Answer:** <answer>
+
+### ❓ <Question 2>
+**Answer:** <answer>
+
+### ❓ <Question 3>
+**Answer:** <answer>

package/templates/review-proposal/review-me-template.md

@@ -0,0 +1,18 @@
+# REVIEW_ME: {{CHANGE_TITLE}}
+
+**Change ID**: `{{CHANGE_ID}}`  
+**Created**: {{DATE}}
+
+**Purpose**: Open questions to review requirements with the user.
+
+## Open Questions
+
+- [ ] Q1: [Question]
+- [ ] Q2: [Question]
+
+## Notes
+
+- Check items off as completed: `[x]`
+- Add comments or findings inline
+- Link to relevant resources or documentation
+- Items are numbered sequentially for easy reference

package/templates/setup-project/project-overview-template.md

@@ -0,0 +1,35 @@
+# [Project Name] - Overview
+
+> **Why this project exists**
+
+[Project description — what it is, who it’s for, and the core outcome it enables.]
+
+## Why [Project Name]
+
+* [Reason 1]
+* [Reason 2]
+
+## [Design Principle / Philosophy]
+
+[Short paragraph explaining the guiding principle (e.g., open source, modular, privacy-first, enterprise-ready) and why that matters.]
+
+## Core Capabilities
+
+### [Capability Area 1 Name]
+
+* [Capability bullet 1]
+* [Capability bullet 2]
+
+### [Capability Area 2 Name]
+
+* [Capability bullet 1]
+* [Capability bullet 2]
+
+## [Operating Model / How It Works] (High-Level)
+
+[High-level description of how the system/process works end-to-end, emphasizing traceability, repeatability, and iteration.]
+
+## Features
+
+* [Feature 1]
+* [Feature 2]

package/templates/setup-project/project-setup-template.md

@@ -0,0 +1,61 @@
+# [Project Name] - Setup
+
+> **How this project is organized**
+
+## Technology Summary
+
+- **Runtime / Language**: [e.g., Node.js 20, Python 3.12, Java 21]
+- **Frameworks**: [e.g., Express, NestJS, FastAPI]
+- **Data / Storage**: [e.g., PostgreSQL, Redis, S3, local filesystem; migrations, backups]
+- **Services / APIs**: [internal services, external dependencies, auth methods]
+- **Frontend / UI**: [e.g., React, Next.js, mobile app, none; design system, accessibility]
+- **Testing / Quality**: [unit, integration, E2E, CI gates, linting]
+- **Infra / Hosting**: [e.g., AWS, GCP, Vercel, on-prem]
+- **CI / CD**: [e.g., GitHub Actions, GitLab CI, Jenkins]
+
+## Repository Layout
+
+[Adjust this tree to match the actual structure of the repository.]
+
+```
+.
+├── src/                # Application source code
+│   ├── modules/        # Feature modules
+│   ├── services/       # Business logic / integrations
+│   └── index.ts        # Entry point
+├── tests/              # Test suites
+├── scripts/            # Dev / ops scripts
+├── .schub/           # 
+│   └── artifacts/      # Agent artifacts (see below)
+├── README.md
+└── package.json
+```
+
+## Validation Artifacts
+
+Temporary files produced while working on a task **must live under**:
+
+```
+.schub/artifacts/<task-id>/...
+```
+
+This directory is reserved for **verifiable outputs** generated during task execution.
+
+### What Belongs Here
+
+Agents should dump and review artifacts here, including (but not limited to):
+
+* Test output logs
+* Screenshots or videos (UI / E2E)
+* Storybook snapshots or interaction traces
+* `curl` or HTTP responses
+* Generated OpenAPI diffs
+* Any files required to prove the change works
+
+### Artifact Requirements
+
+Artifacts must be:
+
+* **Concrete** – not placeholders or descriptions
+* **Inspectable** – viewable or runnable by others
+* **Referenced** – explicitly cited when proving that a change works

package/templates/setup-project/project-wow-template.md

@@ -0,0 +1,130 @@
+# [Project Name] — Ways of Working
+
+> **How to write and verify code here**
+
+## Sources of Truth
+
+- **What does it do today?** → Read the code
+- **Why does it work this way?** → ADRs and comments
+- **How should I build this?** → Proposals, Tasks
+- **What do we promise users?** → Documentation
+
+## CODING & TESTING RULES
+
+### Default Behavior
+
+* [Default rule 1]
+* [Default rule 2]
+* [Default rule 3]
+* **[Default rule 4]** when [condition]
+
+## Required Workflow: [Workflow Name]
+
+Follow this loop **every time**:
+
+### 1. [Step 1 Name] — [Step 1 Summary]
+
+[Short instruction.]
+
+* [Rule 1]
+* [Rule 2]
+* [Rule 3]
+
+[Verification sentence.]
+
+### 2. [Step 2 Name] — [Step 2 Summary]
+
+* [Rule 1]
+* [Rule 2]
+* [Rule 3]
+
+[Execution guidance.]
+
+### 3. [Step 3 Name] — [Step 3 Summary]
+
+* [Rule 1]
+* [Rule 2]
+* [Rule 3]
+
+[Invariant statement.]
+
+### 4. [Step 4 Name] (Required)
+
+Every change must include **[proof requirement]**.
+
+Proof must be:
+
+* [Where it must be referenced]
+
+Include:
+
+* [Exact commands requirement]
+* [Observable output requirement]:
+
+  * [Artifact type 1]
+  * [Artifact type 2]
+  * [Artifact type 3]
+  * [Artifact type 4]
+
+[Verification procedure:]
+
+1. [Verification step 1]
+2. [Verification step 2]
+
+## Required Validation Commands
+
+After **any** change, run **all** of these in order:
+
+```bash
+[command 1]
+[command 2]
+[command 3]
+[command 4]
+```
+
+If the change affects [area(s)]:
+
+* [Additional requirement 1]
+* [Additional requirement 2]
+* [Additional requirement 3]
+
+## Coding Style Rules
+
+### General
+
+* [Style rule 1]
+* [Style rule 2]
+* [Style rule 3]
+
+### Example
+
+✅ Good
+
+```ts
+[good example]
+```
+
+❌ Bad
+
+```ts
+[bad example]
+```
+
+## [Framework] Rules
+
+* [Framework rule 1]
+* [Framework rule 2]
+* [Framework rule 3]
+
+## Testing Rules
+
+* [Testing rule 1]
+* [Testing rule 2]
+
+## Final Rule
+
+If something is unclear:
+
+1. [Fallback step 1]
+2. [Fallback step 2]
+3. [Fallback step 3]

package/templates/setup-project/review-me-template.md

@@ -0,0 +1,18 @@
+# REVIEW_ME: {{CHANGE_TITLE}}
+
+**Change ID**: `{{CHANGE_ID}}`  
+**Created**: {{DATE}}
+
+**Purpose**: Open questions to review requirements with the user.
+
+## Open Questions
+
+- [ ] Q1: [Question]
+- [ ] Q2: [Question]
+
+## Notes
+
+- Check items off as completed: `[x]`
+- Add comments or findings inline
+- Link to relevant resources or documentation
+- Items are numbered sequentially for easy reference