feat: add ADR directory, DEVELOPMENT.md, issue templates, test framework decision (P.3.1, P.4.1, P.4.4, P.4.5)

Copilot · hotlong · Copilot · commit 899aa07412b4 · 2026-02-12T12:15:19.000Z
Co-authored-by: hotlong &lt;50353452+hotlong@users.noreply.github.com&gt;
diff --git a/.github/ISSUE_TEMPLATE/bug_report.yml b/.github/ISSUE_TEMPLATE/bug_report.yml
@@ -0,0 +1,74 @@
+name: 🐛 Bug Report
+description: Report a bug in ObjectOS
+title: '[Bug]: '
+labels: ['bug', 'triage']
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for taking the time to report a bug! Please fill out the information below.
+
+  - type: input
+    id: package
+    attributes:
+      label: Affected Package
+      description: Which package(s) are affected?
+      placeholder: e.g., @objectos/cache, @objectos/workflow, apps/web
+    validations:
+      required: true
+
+  - type: textarea
+    id: description
+    attributes:
+      label: Bug Description
+      description: A clear and concise description of what the bug is.
+    validations:
+      required: true
+
+  - type: textarea
+    id: reproduction
+    attributes:
+      label: Steps to Reproduce
+      description: Steps to reproduce the behavior.
+      value: |
+        1. ...
+        2. ...
+        3. ...
+    validations:
+      required: true
+
+  - type: textarea
+    id: expected
+    attributes:
+      label: Expected Behavior
+      description: What did you expect to happen?
+    validations:
+      required: true
+
+  - type: textarea
+    id: actual
+    attributes:
+      label: Actual Behavior
+      description: What actually happened?
+    validations:
+      required: true
+
+  - type: input
+    id: node-version
+    attributes:
+      label: Node.js Version
+      placeholder: e.g., 20.11.0
+    validations:
+      required: true
+
+  - type: input
+    id: os
+    attributes:
+      label: Operating System
+      placeholder: e.g., macOS 14.3, Ubuntu 22.04, Windows 11
+
+  - type: textarea
+    id: additional
+    attributes:
+      label: Additional Context
+      description: Add any other context, logs, or screenshots.
diff --git a/.github/ISSUE_TEMPLATE/feature_request.yml b/.github/ISSUE_TEMPLATE/feature_request.yml
@@ -0,0 +1,58 @@
+name: ✨ Feature Request
+description: Suggest a new feature for ObjectOS
+title: '[Feature]: '
+labels: ['enhancement']
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for suggesting a feature! Please describe your idea below.
+
+  - type: input
+    id: package
+    attributes:
+      label: Target Package
+      description: Which package(s) would this feature affect?
+      placeholder: e.g., @objectos/workflow, apps/web, new package
+    validations:
+      required: true
+
+  - type: textarea
+    id: problem
+    attributes:
+      label: Problem Statement
+      description: What problem does this feature solve? Is it related to a frustration?
+    validations:
+      required: true
+
+  - type: textarea
+    id: solution
+    attributes:
+      label: Proposed Solution
+      description: Describe the solution you'd like.
+    validations:
+      required: true
+
+  - type: textarea
+    id: alternatives
+    attributes:
+      label: Alternatives Considered
+      description: Describe any alternative solutions or features you've considered.
+
+  - type: dropdown
+    id: scope
+    attributes:
+      label: Scope
+      description: How large is this feature?
+      options:
+        - Small (single package, < 1 day)
+        - Medium (multiple packages, 1-3 days)
+        - Large (cross-cutting, > 3 days)
+    validations:
+      required: true
+
+  - type: textarea
+    id: additional
+    attributes:
+      label: Additional Context
+      description: Add any other context, mockups, or references.
diff --git a/.github/ISSUE_TEMPLATE/plugin_proposal.yml b/.github/ISSUE_TEMPLATE/plugin_proposal.yml
@@ -0,0 +1,67 @@
+name: 🔌 Plugin Proposal
+description: Propose a new ObjectOS plugin
+title: '[Plugin]: '
+labels: ['plugin', 'proposal']
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Proposing a new plugin for the ObjectOS platform? Please describe it below.
+        See the [Plugin Development Guide](../docs/guide/plugin-development.md) for reference.
+
+  - type: input
+    id: name
+    attributes:
+      label: Plugin Name
+      description: The proposed package name.
+      placeholder: e.g., @objectos/sms, @objectos/payment
+    validations:
+      required: true
+
+  - type: textarea
+    id: purpose
+    attributes:
+      label: Purpose
+      description: What does this plugin do? What problem does it solve?
+    validations:
+      required: true
+
+  - type: textarea
+    id: api
+    attributes:
+      label: Proposed API
+      description: Describe the plugin's public API surface (methods, events, config options).
+      value: |
+        ```typescript
+        // Example plugin config
+        interface PluginConfig {
+          // ...
+        }
+
+        // Example events emitted
+        // plugin.event_name
+        ```
+    validations:
+      required: true
+
+  - type: textarea
+    id: dependencies
+    attributes:
+      label: Dependencies
+      description: What existing ObjectOS packages does this plugin depend on?
+      placeholder: e.g., @objectos/auth, @objectos/jobs, @objectos/notification
+
+  - type: textarea
+    id: endpoints
+    attributes:
+      label: API Endpoints
+      description: What REST/GraphQL/WebSocket endpoints will this plugin expose?
+      placeholder: |
+        GET /api/v1/plugin-name/...
+        POST /api/v1/plugin-name/...
+
+  - type: textarea
+    id: additional
+    attributes:
+      label: Additional Context
+      description: Add any other context, diagrams, or references.
diff --git a/ROADMAP.md b/ROADMAP.md
@@ -439,7 +439,7 @@ A comprehensive scan of the entire codebase identified the following improvement
 
 | #     | Task                                                              | Priority | Status |
 | ----- | ----------------------------------------------------------------- | :------: | :----: |
-| P.3.1 | Evaluate test framework unification (Jest vs Vitest) — choose one |    🟡    |   ⬜   |
+| P.3.1 | Evaluate test framework unification (Jest vs Vitest) — choose one |    🟡    |   ✅   |
 | P.3.2 | Add coverage reporting with minimum thresholds per package        |    🟡    |   ⬜   |
 | P.3.3 | Add test coverage aggregation to CI pipeline                      |    🟢    |   ⬜   |
 | P.3.4 | Add snapshot testing guidelines to CONTRIBUTING.md                |    🟢    |   ⬜   |
@@ -448,11 +448,11 @@ A comprehensive scan of the entire codebase identified the following improvement
 
 | #     | Task                                                                               | Priority | Status |
 | ----- | ---------------------------------------------------------------------------------- | :------: | :----: |
-| P.4.1 | Create `DEVELOPMENT.md` with step-by-step local setup guide                        |    🟡    |   ⬜   |
+| P.4.1 | Create `DEVELOPMENT.md` with step-by-step local setup guide                        |    🟡    |   ✅   |
 | P.4.2 | Add `pnpm create:plugin` template with README, test scaffold, and CI config        |    🟡    |   ⬜   |
 | P.4.3 | Add interactive `objectstack doctor` checks for common environment issues          |    🟢    |   ⬜   |
-| P.4.4 | Create architecture decision records (ADR) directory for key decisions             |    🟢    |   ⬜   |
-| P.4.5 | Add GitHub issue templates for bug reports, feature requests, and plugin proposals |    🟢    |   ⬜   |
+| P.4.4 | Create architecture decision records (ADR) directory for key decisions             |    🟢    |   ✅   |
+| P.4.5 | Add GitHub issue templates for bug reports, feature requests, and plugin proposals |    🟢    |   ✅   |
 
 ---
 
@@ -531,15 +531,16 @@ A comprehensive scan of the entire codebase identified the following improvement
 ### v2.3.0 — Developer Experience: Testing (Target: March 2026)
 
 - Phase P.3: Test Infrastructure Standardization
-  - Framework unification decision ⬜
+  - Framework unification decision: Vitest selected (ADR-001) ✅
   - Coverage reporting and CI integration ⬜
 
 ### v2.4.0 — Developer Experience: Onboarding (Target: April 2026)
 
 - Phase P.4: Developer Onboarding
-  - Step-by-step local setup guide ⬜
+  - DEVELOPMENT.md step-by-step local setup guide ✅
   - Plugin creation template improvements ⬜
-  - ADR directory for architecture decisions ⬜
+  - ADR directory with ADR-001 (Vitest standardization) ✅
+  - GitHub issue templates (bug report, feature request, plugin proposal) ✅
 
 ### Master Timeline
 
