@rijalpermana/spec-forge 0.1.0

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "@rijalpermana/spec-forge",
+  "version": "0.1.0",
+  "description": "Spec-driven development CLI: scaffolds specs, schemas, API contracts, task lists, and test cases; bridges into Claude Code as slash commands.",
+  "type": "module",
+  "license": "MIT",
+  "author": "Rijal Permana <rijalpermana00@gmail.com>",
+  "keywords": [
+    "cli",
+    "spec-driven",
+    "scaffold",
+    "prd",
+    "claude-code",
+    "dbml",
+    "api-contract"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "bin": {
+    "forge": "./dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "templates"
+  ],
+  "scripts": {
+    "build": "bun build ./src/cli.ts --outdir ./dist --target node",
+    "prepublishOnly": "bun run build",
+    "link": "bun link"
+  },
+  "dependencies": {
+    "commander": "^12.1.0",
+    "prompts": "^2.4.2"
+  },
+  "devDependencies": {
+    "@types/prompts": "^2.4.9",
+    "bun-types": "^1.3.14",
+    "typescript": "^5.5.4"
+  }
+}

package/templates/api-contract.md

@@ -0,0 +1,7 @@
+# API Contract — {{feature}}
+
+Title: sample title
+endpoint: GET xxxx/xxx
+Request: [details]
+Response: [all responses in json]
+Note: [if available]

package/templates/brief.md

@@ -0,0 +1,21 @@
+# Smelt Brief — {{feature}}
+
+Captured on: {{date}}
+
+## Goal
+{{goal}}
+
+## Actors
+{{actors}}
+
+## Key constraints
+{{constraints}}
+
+## Out of scope (explicit)
+{{outOfScope}}
+
+---
+Next step: open this file in Claude Code / Claude Desktop and ask it to draft
+`prd.md` in this same folder using this brief as grounding context. Do not let
+the AI invent scope not covered here — send it back to `forge smelt {{feature}}`
+to re-run the Q&A if something's missing.

package/templates/codebase.md

@@ -0,0 +1,32 @@
+# Codebase Map
+
+> Generated by `forge scan` on {{generatedAt}}. This is a **factual inventory**
+> of the existing project — deterministic, no interpretation. Use it as grounding
+> before drafting specs: prefer the conventions, entities, and files that already
+> exist here over inventing new ones. Re-run `forge scan` to refresh.
+
+## Project
+
+{{project}}
+
+## Detected stack
+
+{{stack}}
+
+## File statistics
+
+{{stats}}
+
+## Existing schema / data-model files
+
+{{schemas}}
+
+## Existing API / route files
+
+{{apis}}
+
+## Directory tree (depth {{depth}})
+
+```
+{{tree}}
+```

package/templates/prd.md

@@ -0,0 +1,29 @@
+# PRD — {{feature}}
+
+> Generated by `forge smelt {{feature}}`. Draft this with AI (Claude Code / Claude Desktop)
+> using brief.md in this folder as grounding context. Replace every [TODO] before running
+> `forge schema`, `forge contract`, or `forge tasks`.
+
+## 1. Background
+[TODO: why this feature exists, business context]
+
+## 2. Goal
+[TODO: one-sentence outcome this feature must deliver]
+
+## 3. Actors / Roles
+[TODO: who interacts with this feature, and how]
+
+## 4. User Stories
+[TODO: As a [role], I want [capability], so that [benefit]. Repeat per story.]
+
+### Acceptance Criteria (Given/When/Then)
+[TODO: per user story]
+
+## 5. Business Rules & Edge Cases
+[TODO: explicit rules, validation logic, edge cases — do not leave implicit]
+
+## 6. Out of Scope
+[TODO: explicitly excluded items, to prevent AI over-building]
+
+## 7. Dependencies
+[TODO: upstream/downstream systems, data sources, other features this depends on]

package/templates/schema.dbml

@@ -0,0 +1,10 @@
+// Schema — {{feature}}
+// Generated by `forge schema {{feature}}`. Derive this from prd.md — do not invent
+// entities that aren't grounded in the PRD's user stories or business rules.
+
+// Table example (replace/remove):
+// Table {{feature}}_items {
+//   id uuid [pk, default: `gen_random_uuid()`]
+//   tenant_id uuid [not null, note: 'RLS scope']
+//   created_at timestamp [not null, default: `now()`]
+// }

package/templates/tasks.md

@@ -0,0 +1,11 @@
+# Tasks — {{feature}}
+
+> Sequence matters. Data/schema tasks before logic tasks before UI tasks.
+> Flag any dependency inversion explicitly (e.g. do not schedule model/logic work
+> before its data source task is complete).
+
+| Task ID | Task | Depends On | Layer | Est. (man-day) | Status |
+| ------ | ------ | ------ | ------ | ------ | ------ |
+| {{feature}}-01 | [TODO] | - | data | - | todo |
+| {{feature}}-02 | [TODO] | {{feature}}-01 | logic | - | todo |
+| {{feature}}-03 | [TODO] | {{feature}}-02 | ui | - | todo |

package/templates/testcases.md

@@ -0,0 +1,5 @@
+# Test Cases — {{feature}}
+
+| No | Test Scenario | Test Case | Test Type | Expected Result | Actual Result | Status | Remark |
+| ------ | ------ | ------ | ------ | ------ | ------ | ------ | ------ |
+| 1 | Diisi dengan Modul / Menu / Fitur | Diisi dengan Item Test | **Positive / Negative** | Diisi dengan hasil yang diharapkan | - | - | - |