@sabaiway/agent-workflow-kit 1.0.0

package/references/templates/handover.md

@@ -0,0 +1,37 @@
+---
+type: state
+lastUpdated: {{DATE}}
+scope: session
+staleAfter: 7d
+owner: handover
+maxLines: 80
+---
+
+# Handover — Session Context
+
+> **Read this FIRST every session.** What we did last, what's open, what's risky.
+> This is a **session delta**: REPLACE the last-session block each time — do not append. Older deltas live in `changelog.md` → `history/`.
+
+**Last session:** {{DATE}}
+**Branch:** {{BRANCH}}
+
+## What was done last session
+
+- Bootstrap — AI-agent memory system initialised.
+
+## What's open right now
+
+- TODO: fill domain-specific sections after the first real task.
+
+## Risks / gotchas for next session
+
+- None recorded yet.
+
+## Quality snapshot
+
+| Check | Status |
+|-------|--------|
+| lint | n/a |
+| type-check | n/a |
+| unit tests | n/a |
+| E2E tests | n/a |

package/references/templates/known_issues.md

@@ -0,0 +1,33 @@
+---
+type: reference
+lastUpdated: {{DATE}}
+scope: permanent
+staleAfter: 30d
+owner: none
+maxLines: 300
+---
+
+# Known Issues
+
+> Every bug we hit. Status, workaround, impact, plan. Avoids re-discovering pain.
+
+## 🔴 Open
+
+### Issue-001 — {{Title}}
+- **Discovered:** {{DATE}}
+- **Status:** Open
+- **Impact:** {{user-facing? dev-only? blocking?}}
+- **Workaround:** {{if any}}
+- **Plan:** {{next action}}
+- **Related files:** `{{src/...}}`
+
+## 🟢 Resolved
+
+### Issue-XXX — {{Title}}
+- **Resolved:** {{DATE}}
+- **Resolution:** {{what fixed it}}
+- **Commit:** {{SHA}}
+
+---
+
+> Resolved issues older than the window are rotated to `history/issues-resolved.md` by the issue-archive script.

package/references/templates/pages/PAGE_TEMPLATE.md

@@ -0,0 +1,53 @@
+---
+type: reference
+lastUpdated: {{DATE}}
+scope: permanent
+staleAfter: 90d
+owner: none
+maxLines: 200
+---
+
+# Page: {{PAGE_NAME}}
+
+**Route:** `{{/path}}`
+**Component:** `{{src/routes/<file>}}`
+
+> Template — copy to `docs/ai/pages/<page>.md` when a route appears. NOT deployed on bootstrap.
+
+## Purpose
+
+{{1–2 sentences.}}
+
+## Layout
+
+```
+{{ASCII or description of regions.}}
+```
+
+## States
+
+| State | Trigger | UI |
+|-------|---------|----|
+| Empty | No data | {{description}} |
+| Loading | Fetch in flight | {{description}} |
+| Ready | Data loaded | {{description}} |
+| Error | Fetch failed | {{description}} |
+
+## User Actions
+
+| Action | Trigger | Result | Validation |
+|--------|---------|--------|------------|
+| — | — | — | — |
+
+## Data Dependencies
+
+- Reads: {{data sources}}
+- Writes: {{mutations}}
+
+## Linked Components
+
+- `{{src/components/...}}`
+
+## Open Questions / TODO
+
+- [ ] —

package/references/templates/pages/index.md

@@ -0,0 +1,23 @@
+---
+type: reference
+lastUpdated: {{DATE}}
+scope: permanent
+staleAfter: 90d
+owner: none
+maxLines: 80
+---
+
+# Pages Index
+
+> Registry of every user-facing page/route. Source of truth for routing.
+
+| Route | Name | Spec | Status |
+|-------|------|------|--------|
+| `/` | Home | [home.md](./home.md) | TODO |
+| `{{/path}}` | {{Name}} | [{{name}}.md](./{{name}}.md) | TODO |
+
+## Shared
+
+- [shared-patterns.md](./shared-patterns.md) — loading, empty, error, modal, form, toast patterns.
+
+> Create one `pages/<page>.md` per route as it appears (use `PAGE_TEMPLATE.md` from the skill). Every page must ship an HTML-validity / a11y E2E test.

package/references/templates/pages/shared-patterns.md

@@ -0,0 +1,30 @@
+---
+type: reference
+lastUpdated: {{DATE}}
+scope: permanent
+staleAfter: 90d
+owner: none
+maxLines: 400
+---
+
+# Shared Page Patterns
+
+> Cross-cutting UI patterns. Copy these, don't reinvent them.
+
+## Loading State
+{{Pattern + example.}}
+
+## Empty State
+{{Pattern + example.}}
+
+## Error State
+{{Pattern + example.}}
+
+## Modal Lifecycle
+{{Pattern + example.}}
+
+## Form Validation Flow
+{{Pattern + example.}}
+
+## Toast / Notification
+{{Pattern + example.}}

package/references/templates/tech_reference.md

@@ -0,0 +1,34 @@
+---
+type: reference
+lastUpdated: {{DATE}}
+scope: permanent
+staleAfter: 90d
+owner: none
+maxLines: 300
+---
+
+# Technical Reference — Patterns & Examples
+
+> Copy-paste-ready snippets for libraries and patterns used in this project. (Mature projects may fold this into a project patterns skill.)
+
+## No Silent Failures
+
+Every internal validation/guard that rejects an action MUST log via the structured logger with context (component, action, ids, inputs). User-facing failures also surface in the UI.
+
+```{{lang}}
+{{Show the project's logger usage. Replace with a real example after first use.}}
+```
+
+## {{Library Name}} — {{Pattern}}
+
+```{{lang}}
+{{Example after first use.}}
+```
+
+---
+
+## Add a section when
+
+- You discover a non-trivial library configuration.
+- You establish a reusable pattern across 2+ files.
+- You hit a gotcha future agents should not re-discover.

package/references/templates/technical_specification.md

@@ -0,0 +1,37 @@
+---
+type: reference
+lastUpdated: {{DATE}}
+scope: permanent
+staleAfter: 90d
+owner: none
+maxLines: 280
+---
+
+# Technical Specification
+
+> Application-level overview: what it does, who uses it, key data models.
+
+## Purpose
+
+{{One-paragraph mission.}}
+
+## Users / Personas
+
+- {{Persona}} — {{what they do}}
+
+## Core Domain Model
+
+```
+{{Entities and relationships, e.g.}}
+User ──owns──> Project ──contains──> Item
+```
+
+## Data Flow
+
+{{Numbered flow: client → API → storage → render.}}
+
+## External Integrations
+
+| Service | Purpose | Auth |
+|---------|---------|------|
+| — | — | — |