Skip to content

Commit 9bb448f

Browse files
committed
fix: move ISSUE_TEMPLATE to correct .github/ location, add feature requests
1 parent 733f340 commit 9bb448f

5 files changed

Lines changed: 61 additions & 34 deletions

File tree

File renamed without changes.

.github/workflows/ISSUE_TEMPLATE/bug-report.md

Lines changed: 0 additions & 26 deletions
This file was deleted.

.github/workflows/ISSUE_TEMPLATE/config.yml

Lines changed: 0 additions & 8 deletions
This file was deleted.

feature-requests/qmd-doc-search.md

Lines changed: 34 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,34 @@
1+
---
2+
name: qmd markdown search integration
3+
about: Integrate qmd as a local CLI search engine for docs/knowledge base
4+
title: 'feat: integrate qmd for markdown document search'
5+
labels: enhancement
6+
assignees: ''
7+
---
8+
9+
**Is your feature request related to a problem?**
10+
As the project's documentation base grows (engine reference docs, ADRs, GDDs, skill files, sprint logs), agents spend increasing context and time searching through plain markdown. The project needs a fast, local, agent-friendly search layer that doesn't require shipping content to external APIs.
11+
12+
**Describe the solution you'd like**
13+
14+
Integrate [qmd](https://github.com/tobi/qmd) (Query Markup Documents) — a mini CLI search engine purpose-built for markdown knowledge bases:
15+
16+
1. **Installation** — Add `@tobilu/qmd` as a dev dependency (npm or bun global install).
17+
2. **Indexing** — Run `qmd index` across key doc directories (`docs/`, `.opencode/agents/`, `.opencode/skills/`, `design/`, `production/`) via a script or pre-commit hook.
18+
3. **Skill / command** — Create an `.opencode/skills/qmd-search/SKILL.md` skill that teaches agents to use:
19+
- `qmd search "..."` for fast BM25 keyword search
20+
- `qmd vsearch "..."` for semantic vector search
21+
- `qmd query "..."` for hybrid (FTS + vector + re-ranking) best-quality search
22+
4. **Context hook integration** — Wire into the `ccgs-hooks.ts` plugin so relevant doc snippets are auto-retrieved as session context when an agent loads.
23+
5. **CI freshness check** — Add a GitHub Action step that validates the qmd index is up-to-date with the doc tree.
24+
25+
**Describe alternatives you've considered**
26+
27+
- **ripgrep / grep** — Fast but no ranking, no semantic search, no relevance scoring.
28+
- **WebFetch for docs** — Requires network, doesn't work for local/private docs.
29+
- **Context7 MCP** — Good for external libraries, not for project-internal docs.
30+
- **Rolling our own FTS** — qmd already bundles BM25 + sqlite-vec embeddings + query expansion + re-ranking in a single CLI. No need to reinvent.
31+
32+
**Additional context**
33+
34+
qmd is authored by tobi (Tobi L.) — well-maintained, MIT-licensed, 24k+ stars. It stores its index in SQLite (FTS5 + sqlite-vec), is fully local, and has no external API dependencies. The `.claude-plugin/` directory in the qmd repo suggests it was designed with AI agent integration in mind.
Lines changed: 27 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,27 @@
1+
---
2+
name: Unity MCP integration
3+
about: Add Unity Engine support alongside existing Godot setup
4+
title: 'feat: Unity MCP integration'
5+
labels: enhancement
6+
assignees: ''
7+
---
8+
9+
**Is your feature request related to a problem?**
10+
The project is currently locked to Godot 4. Unity developers cannot contribute or prototype within this repo's agent framework. The `.opencode/agents/` directory has dedicated Unity specialist agents (`unity-specialist`, `unity-dots-specialist`, etc.) but no tooling, MCP server, or engine reference docs to back them up.
11+
12+
**Describe the solution you'd like**
13+
14+
1. **Unity MCP server** — Install and configure a Unity MCP server (e.g., `unity-mcp`) so agents can inspect scenes, assets, and project state directly from conversation.
15+
2. **Engine reference docs** — Populate `docs/engine-reference/unity/` with version-pinned API snapshots for the target Unity version (determine via `hub` or project file).
16+
3. **Agent wiring** — Configure the existing Unity specialist agents in `.opencode/agents/` to use the MCP server and reference docs.
17+
4. **Template documentation** — Add Unity-specific sections to `setup-engine` skill and onboarding flow (`/start`, `/setup-engine unity <version>`).
18+
19+
**Describe alternatives you've considered**
20+
21+
- Dual-repo setup (Godot + Unity in separate repos) — loses cross-studio coordination and shared agent config.
22+
- Unreal-only + Godot — doesn't cover the Unity use case.
23+
- Manual Unity workflows without MCP — agents can't inspect project state, severely limiting automated dev-story and code-review.
24+
25+
**Additional context**
26+
27+
The OCGS template already ships Unity specialist agents at `.opencode/agents/unity-specialist.md`, `unity-dots-specialist.md`, `unity-shader-specialist.md`, `unity-addressables-specialist.md`, and `unity-ui-specialist.md`. This FR activates them.

0 commit comments

Comments
 (0)