Skip to content

Commit 1d057e3

Browse files
vybeEugene Vyborovclaude
authored
docs: two-tracker public/private issue tracking (open-core) (#1212)
* docs: split issue tracking into public/private trackers (open-core) Reconcile contributor-facing docs and the issue-template chooser with the two-tracker model: bugs/refactor/docs -> public abilityai/trinity; features/epics -> private abilityai/trinity-enterprise. - CONTRIBUTING/README: feature requests now route to Discussions (Ideas); issues are bugs-only. Removed the public Feature Request template; the New Issue chooser offers Bug Report + a "Request a feature" link to Discussions, with blank_issues_enabled: false. bug_report uses type-bug. - CLAUDE.md / AGENTS.md: routing pointer to DEVELOPMENT_WORKFLOW Repository Routing. - docs/OSS_VS_ENTERPRISE: new "Issue tracking (two-tracker model)" section. - docs/GITHUB_ISSUES_MIGRATION: marked superseded. - Bump .claude (trinity-dev) submodule: workflow doc + skill reconciliation. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com> * docs: move OSS_VS_ENTERPRISE.md to private enterprise repo The comparison doc holds enterprise roadmap intent (in-development/planned modules, tiering direction, licensing status). Per the two-tracker open-core model this belongs in the private tracker, not the public repo. Relocated to abilityai/trinity-enterprise:docs/OSS_VS_ENTERPRISE.md (commit 50318ff). Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com> --------- Co-authored-by: Eugene Vyborov <eugene@beingluminous.com> Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
1 parent fcfb93a commit 1d057e3

9 files changed

Lines changed: 30 additions & 40 deletions

File tree

.claude

.github/ISSUE_TEMPLATE/bug_report.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
name: Bug Report
33
about: Report a bug to help us improve Trinity
44
title: '[BUG] '
5-
labels: bug
5+
labels: type-bug
66
assignees: ''
77
---
88

.github/ISSUE_TEMPLATE/config.yml

Lines changed: 7 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,11 @@
1-
blank_issues_enabled: true
1+
blank_issues_enabled: false
22
contact_links:
3+
- name: 💡 Request a feature / share an idea
4+
url: https://github.com/abilityai/trinity/discussions/new?category=ideas
5+
about: Feature requests go in Discussions → Ideas. Maintainers triage accepted ideas onto the roadmap. The issue tracker is for bugs and core maintenance only.
6+
- name: Questions & general discussion
7+
url: https://github.com/abilityai/trinity/discussions
8+
about: Ask questions, share what you built, and discuss with the community
39
- name: Documentation
410
url: https://github.com/abilityai/trinity#documentation
511
about: Check the documentation before opening an issue
6-
- name: Discussions
7-
url: https://github.com/abilityai/trinity/discussions
8-
about: Ask questions and discuss features

.github/ISSUE_TEMPLATE/feature_request.md

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

AGENTS.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -121,7 +121,7 @@ Caveats that matter to agents:
121121
- Tests: `python -m pytest -v --tb=short` (markers: `unit` needs no backend, `requires_agent` needs a running agent).
122122
- Layout: `src/backend` (FastAPI), `src/frontend` (Vue 3 + Pinia), `src/mcp-server` (TypeScript MCP proxy), `src/cli`, `docker/base-image` (agent runtime).
123123
- Backend pattern: router → service → db (`src/backend/routers|services|db`); schema changes require a versioned migration in `src/backend/db/migrations.py`.
124-
- Workflow: GitHub Issues with priority/type/theme labels; feature branches off `dev`; PRs target `dev` (releases merge `dev``main`). See [CONTRIBUTING.md](CONTRIBUTING.md).
124+
- Workflow: GitHub Issues with priority/type/theme labels; feature branches off `dev`; PRs target `dev` (releases merge `dev``main`). **Two-tracker open-core model:** bugs/refactor/docs live in public `abilityai/trinity`; features/epics in private `abilityai/trinity-enterprise` (see `.claude/DEVELOPMENT_WORKFLOW.md` → Repository Routing). See [CONTRIBUTING.md](CONTRIBUTING.md).
125125

126126
## Documentation map
127127

CLAUDE.md

Lines changed: 6 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -90,7 +90,9 @@ All work follows a 4-stage lifecycle tracked via **GitHub Issues** (labels + ope
9090
- **In Dev**: PR squash-merged to `dev``status-in-dev` label, awaiting the next release cut (dev → main)
9191
- **Done**: Release PR merged to `main`, issue auto-closed via `Closes #N`
9292

93-
**Full details**: `.claude/DEVELOPMENT_WORKFLOW.md`
93+
**Two trackers (open-core).** Issues route by type: `type-bug`/`type-refactor`/`type-docs` → public `abilityai/trinity`; `type-feature`/`type-epic` → private `abilityai/trinity-enterprise`. Tracker ≠ code repo — core code still lands as a public-repo PR. Query/picking skills union both trackers.
94+
95+
**Full details**: `.claude/DEVELOPMENT_WORKFLOW.md` (→ Repository Routing)
9496

9597
---
9698

@@ -108,7 +110,7 @@ All work follows a 4-stage lifecycle tracked via **GitHub Issues** (labels + ope
108110
- No creating documentation files unless explicitly requested
109111

110112
### 3. Follow the Roadmap
111-
- Check **GitHub Issues** for current priorities (`/roadmap` or `gh issue list`) — labels are the single source of truth
113+
- Check **GitHub Issues** for current priorities (`/roadmap` or `gh issue list`) — labels are the single source of truth. `/roadmap` unions both trackers (public bugs + private features/epics); a raw `gh issue list` sees only one repo — pass `--repo abilityai/trinity-enterprise` for feature/epic work
112114
- Work P0 issues first, then P1 (`type-bug` before `type-feature`, then newest issue number first), then P2/P3
113115
- Assign yourself and update `status-*` labels as you progress (see SDLC above)
114116
- Close issues when complete
@@ -155,7 +157,7 @@ Long-running multi-stage work inside agents (perception → synthesis → publis
155157
| `docs/planning/TARGET_ARCHITECTURE.md` | **Target system design + active orchestration direction** — pull / work-stealing coordination (Epic #1045, umbrella #1081). Use when evaluating tradeoffs and prioritizing work; consult before touching `task_execution_service`, `capacity_manager`, `slot_service`, `backlog_service`, `dispatch_breaker`, or `cleanup_service`. |
156158
| `docs/memory/feature-flows.md` | Index of vertical slice docs |
157159
| `docs/archive/plans/ORCHESTRATION_RELIABILITY_2026-04.md` | **Archived (historical)** — completed Sprint A–D′ execution-reliability plan (all shipped). Superseded 2026-06-05 by the pull-coordination direction in `TARGET_ARCHITECTURE.md`. Read for background on the slot/backlog/cleanup machinery. |
158-
| GitHub Issues | Prioritized task queue — labels are authoritative: priority (P0-P3), type, `theme-*`, `complexity-*`; status via `status-*` labels + open/closed; epics are `type-epic` issues with native sub-issues. No project board. |
160+
| GitHub Issues | Prioritized task queue — labels are authoritative: priority (P0-P3), type, `theme-*`, `complexity-*`; status via `status-*` labels + open/closed; epics are `type-epic` issues with native sub-issues. No project board. **Two trackers:** bugs/refactor/docs in public `abilityai/trinity`, features/epics in private `abilityai/trinity-enterprise` (see `.claude/DEVELOPMENT_WORKFLOW.md` → Repository Routing). |
159161

160162
---
161163

@@ -343,7 +345,7 @@ The **[abilities](https://github.com/abilityai/abilities)** repo is the canonica
343345
- **Orchestration Reliability Plan (archived)**: `docs/archive/plans/ORCHESTRATION_RELIABILITY_2026-04.md` ← Sprint A–D′ historical record; superseded by `docs/planning/TARGET_ARCHITECTURE.md` (pull coordination) as the active execution-stack direction
344346
- **Full Architecture**: @docs/memory/architecture.md
345347
- **All Requirements**: `.claude/memory/requirements.md`
346-
- **Current Roadmap**: https://github.com/abilityai/trinity/issues
348+
- **Current Roadmap**: https://github.com/abilityai/trinity/issues (public bugs) + private `abilityai/trinity-enterprise` (features/epics) — use `/roadmap` to see both
347349
- **Recent Changes**: `git log --oneline --since="2 weeks ago"`
348350
- **Agent Guide**: `docs/TRINITY_COMPATIBLE_AGENT_GUIDE.md`
349351
- **Agent Network Demo**: `docs/AGENT_NETWORK_DEMO.md`

CONTRIBUTING.md

Lines changed: 11 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -14,6 +14,12 @@ Trinity is licensed under the [Apache License 2.0](LICENSE). Unless you explicit
1414

1515
## How to Contribute
1616

17+
> **Where things are tracked.** Trinity is open-core. The public issue tracker
18+
> ([abilityai/trinity](https://github.com/abilityai/trinity/issues)) is for
19+
> **bugs and core maintenance**. Feature ideas and roadmap discussion happen in
20+
> [Discussions](https://github.com/abilityai/trinity/discussions) — maintainers
21+
> triage accepted proposals into the product roadmap.
22+
1723
### Reporting Bugs
1824

1925
1. Check if the issue already exists in [GitHub Issues](https://github.com/abilityai/trinity/issues)
@@ -26,10 +32,11 @@ Trinity is licensed under the [Apache License 2.0](LICENSE). Unless you explicit
2632

2733
### Suggesting Features
2834

29-
1. Open an issue with the `enhancement` label
30-
2. Describe the use case and problem you're solving
31-
3. Propose a solution (optional)
32-
4. Be open to discussion and alternatives
35+
Feature ideas go in **Discussions**, not Issues — the public tracker stays focused on bugs, and maintainers curate the roadmap from accepted proposals.
36+
37+
1. Open a [Discussion](https://github.com/abilityai/trinity/discussions) describing the use case and the problem you're solving
38+
2. Propose a solution (optional) and be open to alternatives
39+
3. Accepted ideas are picked up by maintainers and tracked on the roadmap
3340

3441
### Pull Requests
3542

README.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -701,8 +701,8 @@ See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
701701
## Community & Support
702702

703703
- **Ask Trinity**: [docs.ability.ai](https://docs.ability.ai) — full documentation with a built-in agent you can chat with for instant answers
704-
- **GitHub Issues**: [Report bugs and request features](https://github.com/abilityai/trinity/issues)
705-
- **GitHub Discussions**: [Ask questions and share ideas](https://github.com/abilityai/trinity/discussions)
704+
- **GitHub Issues**: [Report bugs](https://github.com/abilityai/trinity/issues) — the public tracker is for bugs & core maintenance
705+
- **GitHub Discussions**: [Request features, ask questions, share ideas](https://github.com/abilityai/trinity/discussions) — feature ideas are triaged into the roadmap here
706706
- **Videos**: [Trinity Demo](https://youtu.be/ivljtZqsxeo) · [Loops Engineering](https://youtu.be/q3YvFYtuhec) · [Autonomous Cornelius](https://youtu.be/QUZ5ZgB5f6E)
707707
- **Free Workshops**: [Live every Thursday + full recording archive](https://www.ability.ai/workshops)
708708
- **Security Issues**: See [SECURITY.md](SECURITY.md) for reporting vulnerabilities

docs/GITHUB_ISSUES_MIGRATION.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# GitHub Issues Migration Plan
22

3-
> **Status**: Migration complete. Roadmap is now tracked via GitHub Issues and the **Trinity Roadmap** project board. The old `docs/memory/roadmap.md` has been archived to `docs/memory/roadmap-archive.md`. See `CONTRIBUTING.md` for the current SDLC.
3+
> **Status**: Historical (migration complete). Roadmap moved from `docs/memory/roadmap.md` (archived to `docs/memory/roadmap-archive.md`) to GitHub Issues. **Superseded since:** the project board was deprecated (issues-only SDLC), and tracking is now split across **two trackers** — public `abilityai/trinity` (bugs/refactor/docs) and private `abilityai/trinity-enterprise` (features/epics). For the current model see `.claude/DEVELOPMENT_WORKFLOW.md` → Repository Routing and `CONTRIBUTING.md`.
44
>
55
> Original purpose: Migrate from `docs/memory/roadmap.md` to GitHub Issues for roadmap tracking.
66

0 commit comments

Comments
 (0)