@open-agent-toolkit/cli 0.0.10

package/assets/templates/docs-app-mkdocs/mkdocs.yml

@@ -0,0 +1,47 @@
+site_name: {{SITE_NAME}}
+docs_dir: './docs'
+
+site_description: {{SITE_NAME}}
+
+plugins:
+  - git-revision-date
+  - macros
+  - search
+  - glightbox
+  - callouts
+
+markdown_extensions:
+  - admonition
+  - attr_list
+  - md_in_html
+  - nl2br
+  - pymdownx.caret
+  - pymdownx.mark
+  - pymdownx.tilde
+  - pymdownx.details
+  - pymdownx.emoji
+  - pymdownx.inlinehilite
+  - pymdownx.highlight:
+      linenums: false
+      guess_lang: true
+  - pymdownx.snippets
+  - pymdownx.superfences:
+      custom_fences:
+        - name: mermaid
+          class: mermaid
+          format: !!python/name:pymdownx.superfences.fence_code_format
+  - pymdownx.tabbed:
+      alternate_style: true
+  - toc:
+      permalink: true
+
+theme:
+  name: material
+  features:
+    - navigation.indexes
+    - content.code.copy
+
+nav:
+  - Home: index.md
+  - Getting Started: getting-started.md
+  - Contributing: contributing.md

package/assets/templates/docs-app-mkdocs/package.json.template

@@ -0,0 +1,19 @@
+{
+  "name": "{{PACKAGE_NAME}}",
+  "type": "module",
+  "private": true,
+  "version": "0.1.0",
+  "description": "MkDocs Material documentation for {{SITE_NAME}}.",
+  "scripts": {
+    "docs:dev": "mkdocs serve",
+    "docs:build": "mkdocs build",
+    "docs:setup": "sh ./setup-docs.sh",
+    "docs:lint": "{{DOCS_LINT_SCRIPT}}",
+    "docs:format": "{{DOCS_FORMAT_SCRIPT}}",
+    "docs:format:check": "{{DOCS_FORMAT_CHECK_SCRIPT}}",
+    "test": "echo 'Documentation tests complete'"
+  },
+  "devDependencies": {
+{{DEV_DEPENDENCIES}}
+  }
+}

package/assets/templates/docs-app-mkdocs/requirements.txt

@@ -0,0 +1,6 @@
+mkdocs==1.4.2
+mkdocs-git-revision-date-plugin==0.3.2
+mkdocs-glightbox==0.3.1
+mkdocs-material==9.0.14
+mkdocs-macros-plugin==0.7.0
+mkdocs-callouts==1.13.2

package/assets/templates/docs-app-mkdocs/setup-docs.sh

@@ -0,0 +1,18 @@
+#!/bin/sh
+
+set -eu
+
+PYTHON_BIN="${PYTHON_BIN:-python3}"
+
+if ! command -v "$PYTHON_BIN" >/dev/null 2>&1; then
+  if command -v python >/dev/null 2>&1; then
+    PYTHON_BIN="python"
+  else
+    echo "Python is required to install MkDocs dependencies." >&2
+    exit 1
+  fi
+fi
+
+echo "Installing Python dependencies for {{APP_NAME}}..."
+"$PYTHON_BIN" -m pip install -r requirements.txt
+echo "Installation successful. You can now run 'mkdocs serve'."

package/assets/templates/ideas/idea-discovery.md

@@ -0,0 +1,39 @@
+---
+oat_idea_state: brainstorming
+oat_idea_created: YYYY-MM-DD
+oat_idea_last_updated: YYYY-MM-DD
+oat_idea_name: '{Idea Name}'
+---
+
+# Idea: {Idea Name}
+
+## What's the Idea?
+
+{Brief description of what this idea is about - 2-3 sentences}
+
+## Why Is It Interesting?
+
+{Why does this matter? What problem does it solve or opportunity does it create?}
+
+## What Would It Look Like?
+
+{Freeform brainstorming about how this might work, what it might include, user experience, etc.}
+
+## Open Questions
+
+{Things that still need to be figured out}
+
+- {Question 1}
+- {Question 2}
+
+## Related Ideas
+
+{Links or references to related thoughts, projects, or external resources}
+
+## Notes & Discussion
+
+{Conversational capture of thoughts as they evolve — each session gets its own header}
+
+### Session: YYYY-MM-DD
+
+{Discussion notes from this session}

package/assets/templates/ideas/idea-summary.md

@@ -0,0 +1,42 @@
+---
+oat_idea_state: summarized
+oat_idea_created: YYYY-MM-DD
+oat_idea_summarized: YYYY-MM-DD
+oat_idea_name: '{Idea Name}'
+---
+
+# Summary: {Idea Name}
+
+## Overview
+
+{2-4 sentence synthesis of the core idea}
+
+## Key Points
+
+- {Main point 1}
+- {Main point 2}
+- {Main point 3}
+
+## Why This Matters
+
+{1-2 sentences on the value or opportunity}
+
+## What It Would Take
+
+{High-level sense of effort, dependencies, or prerequisites}
+
+## Next Steps (If Pursuing)
+
+- [ ] {Next action 1}
+- [ ] {Next action 2}
+
+## Open Questions
+
+{Remaining unknowns that would need to be resolved}
+
+- {Question 1}
+- {Question 2}
+
+## References
+
+{Links to related resources, discussions, or documentation}

package/assets/templates/ideas/ideas-backlog.md

@@ -0,0 +1,21 @@
+# Ideas Backlog
+
+Captured ideas from brainstorming sessions. Each idea has a full discovery document in its own directory under `.oat/ideas/`.
+
+## How to Use
+
+- New ideas start in **Active Brainstorming** (created by `oat-idea-new`)
+- When summarized, they move to **Captured Ideas** (via `oat-idea-summarize`)
+- Archive completed, abandoned, or promoted ideas to **Archived**
+
+## Active Brainstorming
+
+Currently exploring these ideas:
+
+## Captured Ideas
+
+Summarized and ready for future consideration:
+
+## Archived
+
+Ideas that have been completed, abandoned, or promoted to projects:

package/assets/templates/ideas/ideas-scratchpad.md

@@ -0,0 +1,10 @@
+# Ideas Scratchpad
+
+Quick-capture pad for idea seeds. Jot down thoughts here before committing to a full brainstorming session.
+
+Each entry has a name, one-liner summary, and optional nested bullets for quick notes. Use `oat-idea-scratchpad` to review or capture entries, or `oat-idea-new` to start brainstorming on one.
+
+## Ideas
+
+- [ ] **{idea name}** - {brief summary} _(YYYY-MM-DD)_
+  - {quick note}

package/assets/templates/implementation.md

@@ -0,0 +1,207 @@
+---
+oat_status: in_progress
+oat_ready_for: null
+oat_blockers: []
+oat_last_updated: YYYY-MM-DD
+oat_current_task_id: p01-t01
+oat_generated: false
+oat_template: true
+oat_template_name: implementation
+---
+
+# Implementation: {Project Name}
+
+**Started:** YYYY-MM-DD
+**Last Updated:** YYYY-MM-DD
+
+> This document is used to resume interrupted implementation sessions.
+>
+> Conventions:
+>
+> - `oat_current_task_id` always points at the **next plan task to do** (not the last completed task).
+> - When all plan tasks are complete, set `oat_current_task_id: null`.
+> - Reviews are **not** plan tasks. Track review status in `plan.md` under `## Reviews` (e.g., `| final | code | passed | ... |`).
+> - Keep phase/task statuses consistent with the Progress Overview table so restarts resume correctly.
+> - Before running the `oat-project-pr-final` skill, ensure `## Final Summary (for PR/docs)` is filled with what was actually implemented.
+
+## Progress Overview
+
+| Phase   | Status      | Tasks | Completed |
+| ------- | ----------- | ----- | --------- |
+| Phase 1 | in_progress | N     | 0/N       |
+| Phase 2 | pending     | N     | 0/N       |
+
+**Total:** 0/{N} tasks completed
+
+---
+
+## Phase 1: {Phase Name}
+
+**Status:** in_progress
+**Started:** YYYY-MM-DD
+
+### Phase Summary (fill when phase is complete)
+
+**Outcome (what changed):**
+
+- {2-5 bullets describing user-visible / behavior-level changes delivered in this phase}
+
+**Key files touched:**
+
+- `{path}` - {why}
+
+**Verification:**
+
+- Run: `{command(s)}`
+- Result: {pass/fail + notes}
+
+**Notes / Decisions:**
+
+- {trade-offs or deviations discovered during implementation}
+
+### Task p01-t01: {Task Name}
+
+**Status:** completed / in_progress / pending / blocked
+**Commit:** {sha} (if completed)
+
+**Outcome (required when completed):**
+
+- {what materially changed (not “did task”, but “system now does X”)}
+
+**Files changed:**
+
+- `{path}` - {why}
+
+**Verification:**
+
+- Run: `{command(s)}`
+- Result: {pass/fail + notes}
+
+**Notes / Decisions:**
+
+- {gotchas, trade-offs, design deltas, important context for future sessions}
+
+**Issues Encountered:**
+
+- {Issue and resolution}
+
+---
+
+### Task p01-t02: {Task Name}
+
+**Status:** pending
+**Commit:** -
+
+**Notes:**
+
+- {Notes will be added during implementation}
+
+---
+
+## Phase 2: {Phase Name}
+
+**Status:** pending
+**Started:** -
+
+### Task p02-t01: {Task Name}
+
+**Status:** pending
+**Commit:** -
+
+---
+
+## Orchestration Runs
+
+> This section is used by `oat-project-subagent-implement` to log parallel execution runs.
+> Each run appends a new subsection — never overwrite prior entries.
+> For single-thread execution (via `oat-project-implement`), this section remains empty.
+
+<!-- orchestration-runs-start -->
+<!-- orchestration-runs-end -->
+
+---
+
+## Implementation Log
+
+Chronological log of implementation progress.
+
+### YYYY-MM-DD
+
+**Session Start:** {time}
+
+- [x] p01-t01: {Task name} - {commit sha}
+- [ ] p01-t02: {Task name} - in progress
+
+**What changed (high level):**
+
+- {short bullets suitable for PR/docs}
+
+**Decisions:**
+
+- {Decision made and rationale}
+
+**Follow-ups / TODO:**
+
+- {anything discovered during implementation that should be captured for later}
+
+**Blockers:**
+
+- {Blocker description} - {status: resolved/pending}
+
+**Session End:** {time}
+
+---
+
+### YYYY-MM-DD
+
+**Session Start:** {time}
+
+{Continue log...}
+
+---
+
+## Deviations from Plan
+
+Document any deviations from the original plan.
+
+| Task | Planned | Actual | Reason |
+| ---- | ------- | ------ | ------ |
+| -    | -       | -      | -      |
+
+## Test Results
+
+Track test execution during implementation.
+
+| Phase | Tests Run | Passed | Failed | Coverage |
+| ----- | --------- | ------ | ------ | -------- |
+| 1     | -         | -      | -      | -        |
+| 2     | -         | -      | -      | -        |
+
+## Final Summary (for PR/docs)
+
+**What shipped:**
+
+- {capability 1}
+- {capability 2}
+
+**Behavioral changes (user-facing):**
+
+- {bullet}
+
+**Key files / modules:**
+
+- `{path}` - {purpose}
+
+**Verification performed:**
+
+- {tests/lint/typecheck/build/manual steps}
+
+**Design deltas (if any):**
+
+- {what changed vs design.md and why}
+
+## References
+
+- Plan: `plan.md`
+- Design: `design.md`
+- Spec: `spec.md`

package/assets/templates/plan.md

@@ -0,0 +1,171 @@
+---
+oat_status: in_progress
+oat_ready_for: null
+oat_blockers: []
+oat_last_updated: YYYY-MM-DD
+oat_phase: plan
+oat_phase_status: in_progress
+oat_plan_hill_phases: [] # phases to pause AFTER completing (empty = every phase)
+oat_plan_source: spec-driven # spec-driven | quick | imported
+oat_import_reference: null # e.g., references/imported-plan.md
+oat_import_source_path: null # original source path provided by user
+oat_import_provider: null # codex | cursor | claude | null
+oat_generated: false
+oat_template: true
+oat_template_name: plan
+---
+
+# Implementation Plan: {Project Name}
+
+> Execute this plan using `oat-project-implement` (sequential) or `oat-project-subagent-implement` (parallel), with phase checkpoints and review gates.
+
+**Goal:** {Brief goal statement from spec}
+
+**Architecture:** {1-2 sentence architecture summary from design}
+
+**Tech Stack:** {Key technologies from design}
+
+**Commit Convention:** `{type}({scope}): {description}` - e.g., `feat(p01-t01): add user auth endpoint`
+
+## Planning Checklist
+
+- [ ] Confirmed HiLL checkpoints with user
+- [ ] Set `oat_plan_hill_phases` in frontmatter
+
+---
+
+## Phase 1: {Phase Name}
+
+### Task p01-t01: {Task Name}
+
+**Files:**
+
+- Create: `{path/to/file.ts}`
+- Modify: `{path/to/existing.ts}`
+
+**Step 1: Write test (RED)**
+
+```typescript
+// {path/to/file.test.ts}
+describe('{feature}', () => {
+  it('{test case}', () => {
+    // Test implementation
+  });
+});
+```
+
+Run: `pnpm test {path/to/file.test.ts}`
+Expected: Test fails (RED)
+
+**Step 2: Implement (GREEN)**
+
+```typescript
+// {path/to/file.ts}
+// Implementation code or interface signatures
+```
+
+Run: `pnpm test {path/to/file.test.ts}`
+Expected: Test passes (GREEN)
+
+**Step 3: Refactor**
+
+{Any cleanup or improvements while tests stay green}
+
+**Step 4: Verify**
+
+Run: `pnpm lint && pnpm type-check`
+Expected: No errors
+
+**Step 5: Commit**
+
+```bash
+git add {files}
+git commit -m "feat(p01-t01): {description}"
+```
+
+---
+
+### Task p01-t02: {Task Name}
+
+**Files:**
+
+- {File list}
+
+**Step 1: Write test (RED)**
+
+{Test code}
+
+**Step 2: Implement (GREEN)**
+
+{Implementation code or signatures}
+
+**Step 3: Refactor**
+
+{Optional cleanup}
+
+**Step 4: Verify**
+
+Run: `{verification command}`
+Expected: {output}
+
+**Step 5: Commit**
+
+```bash
+git add {files}
+git commit -m "feat(p01-t02): {description}"
+```
+
+---
+
+## Phase 2: {Phase Name}
+
+### Task p02-t01: {Task Name}
+
+{Continue TDD pattern...}
+
+---
+
+## Reviews
+
+{Track reviews here after running the oat-project-review-provide and oat-project-review-receive skills.}
+
+{Keep both code + artifact rows below. Add additional code rows (p03, p04, etc.) as needed, but do not delete `spec`/`design`.}
+
+| Scope  | Type     | Status  | Date | Artifact |
+| ------ | -------- | ------- | ---- | -------- |
+| p01    | code     | pending | -    | -        |
+| p02    | code     | pending | -    | -        |
+| final  | code     | pending | -    | -        |
+| spec   | artifact | pending | -    | -        |
+| design | artifact | pending | -    | -        |
+
+**Status values:** `pending` → `received` → `fixes_added` → `fixes_completed` → `passed`
+
+**Meaning:**
+
+- `received`: review artifact exists (not yet converted into fix tasks)
+- `fixes_added`: fix tasks were added to the plan (work queued)
+- `fixes_completed`: fix tasks implemented, awaiting re-review
+- `passed`: re-review run and recorded as passing (no Critical/Important)
+
+---
+
+## Implementation Complete
+
+**Summary:**
+
+- Phase 1: {N} tasks - {Description}
+- Phase 2: {N} tasks - {Description}
+
+**Total: {N} tasks**
+
+Ready for code review and merge.
+
+---
+
+## References
+
+- Design: `design.md` (required in spec-driven mode; optional in quick/import mode)
+- Spec: `spec.md` (required in spec-driven mode; optional in quick/import mode)
+- Discovery: `discovery.md`
+- Imported Source: `references/imported-plan.md` (when `oat_plan_source: imported`)

package/assets/templates/roadmap.md

@@ -0,0 +1,24 @@
+---
+oat_template: true
+oat_template_name: roadmap
+---
+
+# Roadmap
+
+## Now (Active / Committed)
+
+<!-- Add active work here. Format:
+- **bl-XXXX: {title}** — brief description. Project: {name} (if linked)
+-->
+
+## Next (Planned)
+
+<!-- Add planned work here. Format:
+- **bl-XXXX: {title}** — brief description. Project: {name} (if linked)
+-->
+
+## Later (Directional Intent)
+
+<!-- Add directional work here. Format:
+- **bl-XXXX: {title}** — brief description. Project: {name} (if linked)
+-->