@jadeit/forge-ai 0.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (55) hide show
  1. package/README.md +57 -0
  2. package/dist/agents/build-agent.md +221 -0
  3. package/dist/agents/deploy-agent.md +256 -0
  4. package/dist/agents/design-agent.md +221 -0
  5. package/dist/agents/feature-dev/approach.md +169 -0
  6. package/dist/agents/feature-dev/clarify.md +131 -0
  7. package/dist/agents/feature-dev/discover.md +113 -0
  8. package/dist/agents/feature-dev/explore.md +124 -0
  9. package/dist/agents/feature-dev/implement.md +200 -0
  10. package/dist/agents/feature-dev/review.md +205 -0
  11. package/dist/agents/feature-dev/summarise.md +187 -0
  12. package/dist/agents/feature-dev/validate.md +211 -0
  13. package/dist/agents/forge-orchestrator.md +188 -0
  14. package/dist/agents/maintain-agent.md +251 -0
  15. package/dist/agents/plan-agent.md +181 -0
  16. package/dist/agents/test-agent.md +215 -0
  17. package/dist/commands/forge-1-plan.md +48 -0
  18. package/dist/commands/forge-2-design.md +51 -0
  19. package/dist/commands/forge-3-build-1-discover.md +34 -0
  20. package/dist/commands/forge-3-build-2-explore.md +30 -0
  21. package/dist/commands/forge-3-build-3-clarify.md +39 -0
  22. package/dist/commands/forge-3-build-4-approach.md +38 -0
  23. package/dist/commands/forge-3-build-5-implement.md +38 -0
  24. package/dist/commands/forge-3-build-6-review.md +50 -0
  25. package/dist/commands/forge-3-build-7-validate.md +49 -0
  26. package/dist/commands/forge-3-build-8-summarise.md +49 -0
  27. package/dist/commands/forge-3-build.md +54 -0
  28. package/dist/commands/forge-4-test.md +45 -0
  29. package/dist/commands/forge-5-deploy.md +50 -0
  30. package/dist/commands/forge-6-maintain.md +66 -0
  31. package/dist/commands/forge-init.md +111 -0
  32. package/dist/commands/forge-status.md +94 -0
  33. package/dist/commands/forge.md +77 -0
  34. package/dist/index.d.ts +4 -0
  35. package/dist/index.d.ts.map +1 -0
  36. package/dist/index.js +5 -0
  37. package/dist/index.js.map +1 -0
  38. package/dist/skills/forge-context-loader/SKILL.md +99 -0
  39. package/dist/skills/forge-quality-checker/SKILL.md +227 -0
  40. package/dist/skills/forge-state-manager/SKILL.md +235 -0
  41. package/dist/skills/forge-template-loader/SKILL.md +162 -0
  42. package/dist/templates/defects/DEFECT_TEMPLATE.md +96 -0
  43. package/dist/templates/design/design-decisions.md +64 -0
  44. package/dist/templates/design/task-list.md +56 -0
  45. package/dist/templates/design/tasks/TASK_TEMPLATE.md +87 -0
  46. package/dist/templates/planning/implementation-plan.md +59 -0
  47. package/dist/templates/planning/project-scope.md +53 -0
  48. package/dist/templates/planning/technology-and-architecture.md +80 -0
  49. package/dist/templates/planning/user-stories.md +48 -0
  50. package/dist/templates/testing/uat-results.md +68 -0
  51. package/dist/version.d.ts +2 -0
  52. package/dist/version.d.ts.map +1 -0
  53. package/dist/version.js +2 -0
  54. package/dist/version.js.map +1 -0
  55. package/package.json +40 -0
@@ -0,0 +1,96 @@
1
+ ---
2
+ title: [Defect Title]
3
+ severity: critical
4
+ classification: implementation
5
+ status: open
6
+ source:
7
+ type: sentry
8
+ url: null
9
+ discovered: null
10
+ affected_features: []
11
+ routed_to: null
12
+ reproduction_steps: []
13
+ expected_behaviour: null
14
+ actual_behaviour: null
15
+ created: null
16
+ last_updated: null
17
+ ---
18
+
19
+ # Defect Report: [Title]
20
+
21
+ ## Summary
22
+
23
+ <!-- One-line summary of the defect -->
24
+
25
+ ## Severity
26
+
27
+ - [ ] Critical - System unusable, data loss risk
28
+ - [ ] High - Major feature broken, no workaround
29
+ - [ ] Medium - Feature broken, workaround exists
30
+ - [ ] Low - Minor issue, cosmetic
31
+
32
+ ## Classification
33
+
34
+ - **Design** - Flawed design that needs revisiting
35
+ - **Implementation** - Incorrect implementation of correct design
36
+
37
+ ## Source
38
+
39
+ | Field | Value |
40
+ |-------|-------|
41
+ | Type | sentry / logs / test / uat / user-report |
42
+ | URL | |
43
+ | Discovered | |
44
+
45
+ ## Affected Features
46
+
47
+ -
48
+
49
+ ## Reproduction Steps
50
+
51
+ 1.
52
+ 2.
53
+ 3.
54
+
55
+ ## Expected Behaviour
56
+
57
+ <!-- What should happen -->
58
+
59
+ ## Actual Behaviour
60
+
61
+ <!-- What actually happens -->
62
+
63
+ ## Screenshots / Logs
64
+
65
+ <!-- Include relevant screenshots or log excerpts -->
66
+
67
+ ## Environment
68
+
69
+ | Field | Value |
70
+ |-------|-------|
71
+ | Browser/OS | |
72
+ | Version | |
73
+ | User Type | |
74
+
75
+ ## Resolution
76
+
77
+ ### Routed To
78
+
79
+ - Design phase (`forge 2:design`)
80
+ - Build phase (`forge 3:build`)
81
+
82
+ ### Root Cause
83
+
84
+ <!-- Analysis of the root cause -->
85
+
86
+ ### Fix Applied
87
+
88
+ <!-- How the defect was resolved -->
89
+
90
+ ### Resolution Date
91
+
92
+ ## Changelog
93
+
94
+ | Date | Action | By |
95
+ |------|--------|-----|
96
+ | | | |
@@ -0,0 +1,64 @@
1
+ ---
2
+ title: Design Decisions
3
+ phase: 2
4
+ status: in-progress
5
+ created: null
6
+ last_updated: null
7
+ ---
8
+
9
+ # Design Decisions
10
+
11
+ ## Decision Record Template
12
+
13
+ | Field | Value |
14
+ |-------|-------|
15
+ | **Decision ID** | ADDR-001 |
16
+ | **Date** | YYYY-MM-DD |
17
+ | **Status** | Proposed / Accepted / Deprecated |
18
+ | **Deciders** | |
19
+ | **Context** | |
20
+ | **Decision** | |
21
+ | **Consequences** | |
22
+
23
+ ---
24
+
25
+ ## ADDR-001: [Title]
26
+
27
+ **Status:** Accepted
28
+
29
+ ### Context
30
+
31
+ <!-- What is the issue or decision being addressed? -->
32
+
33
+ ### Decision
34
+
35
+ <!-- What is the change that is proposed or has been made? -->
36
+
37
+ ### Alternatives Considered
38
+
39
+ 1. **Option A:**
40
+ - Pros:
41
+ - Cons:
42
+
43
+ 2. **Option B:**
44
+ - Pros:
45
+ - Cons:
46
+
47
+ ### Consequences
48
+
49
+ **Positive:**
50
+ -
51
+
52
+ **Negative:**
53
+ -
54
+
55
+ **Neutral:**
56
+ -
57
+
58
+ ---
59
+
60
+ ## Decision Index
61
+
62
+ | ID | Title | Status | Date |
63
+ |----|-------|--------|------|
64
+ | ADDR-001 | | | |
@@ -0,0 +1,56 @@
1
+ ---
2
+ title: Task List
3
+ phase: 2
4
+ status: in-progress
5
+ created: null
6
+ last_updated: null
7
+ ---
8
+
9
+ # Task List
10
+
11
+ ## Summary
12
+
13
+ | Total Tasks | Small | Medium | Large |
14
+ |-------------|-------|--------|-------|
15
+ | | | | |
16
+
17
+ ## Tasks by Category
18
+
19
+ ### Backend
20
+ | Task Slug | Title | Complexity | Dependencies |
21
+ |-----------|-------|------------|--------------|
22
+ | | | | |
23
+
24
+ ### Frontend
25
+ | Task Slug | Title | Complexity | Dependencies |
26
+ |-----------|-------|------------|--------------|
27
+ | | | | |
28
+
29
+ ### Infrastructure
30
+ | Task Slug | Title | Complexity | Dependencies |
31
+ |-----------|-------|------------|--------------|
32
+ | | | | |
33
+
34
+ ### Database
35
+ | Task Slug | Title | Complexity | Dependencies |
36
+ |-----------|-------|------------|--------------|
37
+ | | | | |
38
+
39
+ ### Documentation
40
+ | Task Slug | Title | Complexity | Dependencies |
41
+ |-----------|-------|------------|--------------|
42
+ | | | | |
43
+
44
+ ## Task Dependencies Graph
45
+
46
+ ```mermaid
47
+ flowchart LR
48
+ A[Task A] --> B[Task B]
49
+ B --> C[Task C]
50
+ ```
51
+
52
+ ## Implementation Order Recommendation
53
+
54
+ 1.
55
+ 2.
56
+ 3.
@@ -0,0 +1,87 @@
1
+ ---
2
+ title: [Task Title]
3
+ status: not-started
4
+ mode: greenfield
5
+ complexity: medium
6
+ categories:
7
+ - backend
8
+ affected_modules: []
9
+ dependencies: []
10
+ acceptance_criteria: []
11
+ created: null
12
+ last_updated: null
13
+ ---
14
+
15
+ # Task: [Title]
16
+
17
+ ## Summary / Objective
18
+
19
+ <!-- What this task achieves and why it is needed -->
20
+
21
+ ## User Story Reference
22
+
23
+ <!-- Link to the user story this task supports: US-XXX -->
24
+
25
+ ## Acceptance Criteria
26
+
27
+ - [ ] Criterion 1
28
+ - [ ] Criterion 2
29
+ - [ ] Criterion 3
30
+
31
+ ## Implementation Detail
32
+
33
+ ### Approach
34
+
35
+ <!-- How to implement this task -->
36
+
37
+ ### Components to Create/Modify
38
+
39
+ | Component | Action | Description |
40
+ |-----------|--------|-------------|
41
+ | | | |
42
+
43
+ ### Illustrative Code
44
+
45
+ ```typescript
46
+ // Example interface or pseudo-code
47
+ interface Example {
48
+ id: string;
49
+ // ...
50
+ }
51
+ ```
52
+
53
+ ### API Changes
54
+
55
+ | Endpoint | Method | Description |
56
+ |----------|--------|-------------|
57
+ | | | |
58
+
59
+ ## Testing Criteria
60
+
61
+ ### Unit Tests
62
+
63
+ - Test case 1
64
+ - Test case 2
65
+
66
+ ### Integration Tests
67
+
68
+ - Integration scenario 1
69
+
70
+ ### Manual Tests
71
+
72
+ - Manual verification step 1
73
+
74
+ ## Edge Cases
75
+
76
+ - Edge case 1 and how it is handled
77
+ - Edge case 2 and how it is handled
78
+
79
+ ## Notes
80
+
81
+ <!-- Additional context, concerns, or decisions -->
82
+
83
+ ## Changelog
84
+
85
+ | Date | Change | By |
86
+ |------|--------|-----|
87
+ | | | |
@@ -0,0 +1,59 @@
1
+ ---
2
+ title: Implementation Plan
3
+ phase: 1
4
+ status: in-progress
5
+ created: null
6
+ last_updated: null
7
+ phases: []
8
+ timeline_estimate: null
9
+ ---
10
+
11
+ # Implementation Plan
12
+
13
+ ## Overview
14
+
15
+ <!-- Brief description of the implementation approach -->
16
+
17
+ ## Phase Breakdown
18
+
19
+ | Phase | Description | Estimated Duration | Dependencies |
20
+ |-------|-------------|-------------------|--------------|
21
+ | 1 | Planning | | - |
22
+ | 2 | Design | | Phase 1 |
23
+ | 3 | Build | | Phase 2 |
24
+ | 4 | Test | | Phase 3 |
25
+ | 5 | Deploy | | Phase 4 |
26
+ | 6 | Maintain | | Phase 5 |
27
+
28
+ ## Phase 3 Implementation Groups
29
+
30
+ ### Group 1: Foundation
31
+ | Task | Description | Complexity |
32
+ |------|-------------|------------|
33
+ | | | |
34
+
35
+ ### Group 2: Core Features
36
+ | Task | Description | Complexity |
37
+ |------|-------------|------------|
38
+ | | | |
39
+
40
+ ### Group 3: Polish
41
+ | Task | Description | Complexity |
42
+ |------|-------------|------------|
43
+ | | | |
44
+
45
+ ## Timeline Estimate
46
+
47
+ **Total Estimated Duration:**
48
+
49
+ ## Milestones
50
+
51
+ | Milestone | Target Date | Delivered By |
52
+ |-----------|-------------|--------------|
53
+ | | | |
54
+
55
+ ## Risk Assessment
56
+
57
+ | Risk | Impact | Likelihood | Mitigation |
58
+ |------|--------|------------|------------|
59
+ | | | | |
@@ -0,0 +1,53 @@
1
+ ---
2
+ title: Project Scope
3
+ phase: 1
4
+ status: in-progress
5
+ created: null
6
+ last_updated: null
7
+ stakeholders: []
8
+ user_personas: []
9
+ high_level_goals: []
10
+ constraints: []
11
+ ---
12
+
13
+ # Project Scope
14
+
15
+ ## Aim
16
+
17
+ <!-- What the project aims to achieve -->
18
+
19
+ ## High-Level Design
20
+
21
+ <!-- Overview of the solution approach -->
22
+
23
+ ## High-Level Technology Choices
24
+
25
+ <!-- Major technologies and frameworks chosen -->
26
+
27
+ ## Stakeholders
28
+
29
+ | Name | Role | Contact |
30
+ |------|------|---------|
31
+ | | | |
32
+
33
+ ## User Personas
34
+
35
+ | Persona | Description | Needs |
36
+ |---------|-------------|-------|
37
+ | | | |
38
+
39
+ ## High-Level Goals
40
+
41
+ 1.
42
+ 2.
43
+ 3.
44
+
45
+ ## Constraints
46
+
47
+ -
48
+ -
49
+
50
+ ## Success Criteria
51
+
52
+ -
53
+ -
@@ -0,0 +1,80 @@
1
+ ---
2
+ title: Technology & Architecture
3
+ phase: 1
4
+ status: in-progress
5
+ created: null
6
+ last_updated: null
7
+ architecture_diagram: null
8
+ tech_stack: []
9
+ diagram_type: c4
10
+ ---
11
+
12
+ # Technology & Architecture
13
+
14
+ ## Architecture Diagram
15
+
16
+ ```mermaid
17
+ %% C4 Model Context Diagram
18
+ C4Context
19
+ title System Context diagram for [System Name]
20
+
21
+ Person(personAlias, "Actor Name", "Actor Description")
22
+ System(systemAlias, "System Name", "System Description")
23
+
24
+ Rel(personAlias, systemAlias, "Uses")
25
+ ```
26
+
27
+ <!-- For C4 Level 1 (Context), use:
28
+ - Person: actors/users
29
+ - System: the system being built and external systems
30
+ -->
31
+
32
+ ## Technology Stack
33
+
34
+ | Category | Technology | Version | Rationale |
35
+ |----------|------------|---------|-----------|
36
+ | Language | | | |
37
+ | Framework | | | |
38
+ | Database | | | |
39
+ | Infrastructure | | | |
40
+ | CI/CD | | | |
41
+ | Monitoring | | | |
42
+
43
+ ## Infrastructure Overview
44
+
45
+ <!-- Describe deployment environment, cloud provider, etc. -->
46
+
47
+ ## System Components
48
+
49
+ | Component | Responsibility | Technology |
50
+ |-----------|---------------|------------|
51
+ | | | |
52
+
53
+ ## Data Architecture
54
+
55
+ ### Data Stores
56
+
57
+ | Store | Purpose | Technology |
58
+ |-------|---------|------------|
59
+ | | | |
60
+
61
+ ### Data Flows
62
+
63
+ ```mermaid
64
+ flowchart LR
65
+ A[Client] --> B[API]
66
+ B --> C[(Database)]
67
+ ```
68
+
69
+ ## Security Considerations
70
+
71
+ -
72
+ -
73
+
74
+ ## Non-Functional Requirements
75
+
76
+ | Requirement | Target | Measurement |
77
+ |-------------|--------|-------------|
78
+ | Performance | | |
79
+ | Availability | | |
80
+ | Scalability | | |
@@ -0,0 +1,48 @@
1
+ ---
2
+ title: User Stories
3
+ phase: 1
4
+ status: in-progress
5
+ created: null
6
+ last_updated: null
7
+ ---
8
+
9
+ # User Stories
10
+
11
+ ## Format
12
+
13
+ "As a **[persona]**, I want **[goal]** so that **[benefit]**."
14
+
15
+ ## User Stories
16
+
17
+ ### US-001
18
+ **As a:**
19
+ **I want:**
20
+ **So that:**
21
+ **Priority:**
22
+
23
+ ### US-002
24
+ **As a:**
25
+ **I want:**
26
+ **So that:**
27
+ **Priority:**
28
+
29
+ ### US-003
30
+ **As a:**
31
+ **I want:**
32
+ **So that:**
33
+ **Priority:**
34
+
35
+ ## Story Map
36
+
37
+ | Story ID | As A | I Want | So That | Priority |
38
+ |----------|------|--------|---------|----------|
39
+ | US-001 | | | | |
40
+ | US-002 | | | | |
41
+ | US-003 | | | | |
42
+
43
+ ## Acceptance Criteria Guidelines
44
+
45
+ Each user story should have clear acceptance criteria:
46
+ - Specific and measurable
47
+ - Testable
48
+ - Agreed upon by stakeholders
@@ -0,0 +1,68 @@
1
+ ---
2
+ title: UAT Results
3
+ phase: 4
4
+ status: in-progress
5
+ created: null
6
+ last_updated: null
7
+ tester: null
8
+ environment: null
9
+ ---
10
+
11
+ # User Acceptance Testing Results
12
+
13
+ ## Test Environment
14
+
15
+ | Field | Value |
16
+ |-------|-------|
17
+ | Date | |
18
+ | Tester | |
19
+ | Environment | |
20
+ | Version | |
21
+
22
+ ## Test Summary
23
+
24
+ | Metric | Count |
25
+ |--------|-------|
26
+ | Total Test Cases | |
27
+ | Passed | |
28
+ | Failed | |
29
+ | Skipped | |
30
+ | Pass Rate | |
31
+
32
+ ## User Story Test Results
33
+
34
+ ### US-001: [User Story Title]
35
+
36
+ | Acceptance Criteria | Result | Notes |
37
+ |--------------------|--------|-------|
38
+ | | | |
39
+
40
+ **Overall:** Passed / Failed / Skipped
41
+
42
+ ---
43
+
44
+ ### US-002: [User Story Title]
45
+
46
+ | Acceptance Criteria | Result | Notes |
47
+ |--------------------|--------|-------|
48
+ | | | |
49
+
50
+ **Overall:** Passed / Failed / Skipped
51
+
52
+ ---
53
+
54
+ ## Defects Found
55
+
56
+ | Defect ID | Title | Severity | User Story | Status |
57
+ |-----------|-------|----------|------------|--------|
58
+ | | | | | |
59
+
60
+ ## Sign-Off
61
+
62
+ | Role | Name | Date | Signature |
63
+ |------|------|------|----------|
64
+ | | | | |
65
+
66
+ ## Comments
67
+
68
+ <!-- Overall feedback and comments -->
@@ -0,0 +1,2 @@
1
+ export declare const version = "0.0.0";
2
+ //# sourceMappingURL=version.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,OAAO,UAAU,CAAC"}
@@ -0,0 +1,2 @@
1
+ export const version = "0.0.0";
2
+ //# sourceMappingURL=version.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAC"}
package/package.json ADDED
@@ -0,0 +1,40 @@
1
+ {
2
+ "name": "@jadeit/forge-ai",
3
+ "version": "0.0.0",
4
+ "description": "Forge AI - Structured AI-augmented coding methodology for OpenCode",
5
+ "main": "dist/index.js",
6
+ "type": "module",
7
+ "exports": {
8
+ ".": "./dist/index.js"
9
+ },
10
+ "files": [
11
+ "dist"
12
+ ],
13
+ "scripts": {
14
+ "build": "bun run build.ts",
15
+ "prepublish": "bun run build"
16
+ },
17
+ "dependencies": {
18
+ "@opencode-ai/plugin": "^1.3.0"
19
+ },
20
+ "devDependencies": {
21
+ "bun-types": "^1.0.0",
22
+ "typescript": "^5.0.0"
23
+ },
24
+ "keywords": [
25
+ "opencode",
26
+ "forge",
27
+ "ai",
28
+ "development",
29
+ "methodology"
30
+ ],
31
+ "author": "Jade IT",
32
+ "license": "MIT",
33
+ "repository": {
34
+ "type": "git",
35
+ "url": "https://github.com/jadeit/forge-ai.git"
36
+ },
37
+ "publishConfig": {
38
+ "access": "public"
39
+ }
40
+ }