JPM-CLI: Just Project Manager

![Node.js Version](https://nodejs.org/)
![License: MIT](https://opensource.org/licenses/MIT)
![PRs Welcome](http://makeapullrequest.com)

> Đọc bằng tiếng Việt 🇻🇳

JPM (Jatrick Project Manager) is a Spec-Driven Development CLI designed to streamline the workflow of AI Agents and Human Developers. It enforces a strict "Plan → Design → Split → Sync" methodology to ensure code quality and project consistency.

---

🌟 Why JPM?

- 🧠 Spec-Driven: No more coding without a plan. PRD and Architecture artifacts are mandatory.
- ⚡ AI-Powered: Uses Google Gemini to generate high-quality specs and task breakdowns.
- 🤝 GitHub Sync: Decomposes big features into "Parent Issues" with trackable Tasklists.
- 🛡️ Master Rule Enforcement: Enforces your project's JPM_MASTER.md rules (Tech Stack, Naming, Design) on every AI generation.

---

📦 Installation

Install globally via NPM:

``

bash

npm install -g jpm-cli





$3



JPM requires a Google Gemini API Key. You can set this up easily:



1.  Run the config command:

bash

    jpm config



    (This opens the global installation directory)

2.  Create or duplicate

.env

 file in that folder.

3.  Add your key:

env

    JPM_API_KEY=your_gemini_api_key_here





---



🚀 Zero to Hero Workflow



$3

Go to your project folder and wake up JPM.

bash

mkdir my-super-app

cd my-super-app

jpm init



Creates

.jpm/ structure and JPM_MASTER.md. Edit JPM_MASTER.md to define your stack!





$3

Generate a Product Requirement Document (PRD).

bash

jpm plan "User Authentication"





$3

Create a technical architecture based on the PRD.

bash

jpm design "User Authentication"





$3

Break the architecture down into atomic, developer-ready tasks.

bash

jpm split "User Authentication"





$3

Push your tasks to GitHub Issues (requires

 CLI).

bash

jpm sync





---



🧹 Maintenance



Clean up cache and backups to save space:

bash

jpm clean





---



🛠️ Tech Stack



- Runtime: Node.js

- Language: TypeScript

- AI: Google Gemini (via

@google/generative-ai

)

- CLI Tools:

inquirer, ora, boxen, commander





---



👨‍💻 Development



If you want to contribute to JPM or modify it locally:



1.  Clone & Install:

bash

    git clone https://github.com/Jpatrick-Phan/JPM.git

    cd JPM

    npm install





2.  Linting & Formatting:

    We use ESLint and Prettier. Run this before committing:

bash

    npm run lint      # Check for issues

    npm run lint -- --fix # Auto-fix issues





3.  Testing:

    Run the test suite (Core + CLI Integration):

bash

    npm test





4.  Local Build:

bash

    npm run build

    # Test your local build:

    node dist/src/index.js -h

``

---

Made with ❤️ by Jatrick