palskills 1.0.0 → 1.0.2

package/README.md

@@ -2,29 +2,7 @@
 
 **AI-powered development pipeline** — a suite of 5 Hermes Agent skills that orchestrate the full development lifecycle: context retrieval → planning → execution via Codex CLI → archival.
 
-```
-User Prompt
-     │
-     ▼
-┌──────────────────────────────────────────────────────┐
-│                                                      │
-│  🔮 Astralym — State Machine Core                    │
-│     Routes every prompt through the pipeline          │
-│                                                      │
-│     ├─► 📖 Lyleen — Palbox Reader & Bootstrapper     │
-│     │   Checks .palbox/ for context; creates if new   │
-│     │                                                 │
-│     ├─► 🐉 Jetdragon — Planner                       │
-│     │   Asks clarifying questions → detailed plan     │
-│     │                                                 │
-│     ├─► ⚔️ Anubis — Codex Development Engine         │
-│     │   Builds Codex prompt → codex exec (SOLID+SRP)  │
-│     │                                                 │
-│     └─► 📝 Panthalus — Palbox Archivist              │
-│         Records plan + execution → .palbox/history/   │
-│                                                      │
-└──────────────────────────────────────────────────────┘
-```
+![Palskills Pipeline](assets/pipeline.jpg?v=2)
 
 ## Skills
 
@@ -70,19 +48,19 @@ palskills
 ║     AI Development Pipeline          ║
 ╚══════════════════════════════════════╝
 
-  Pilih coding agent:
+  Select coding agent:
 
   [1] Codex CLI     → .codex.md
   [2] Cursor        → .cursorrules
   [3] Claude Code   → CLAUDE.md
-  [4] Semua         → generate all
+  [4] All           → generate all
 
-  Pilih [1-4]:
+  Choose [1-4]:
 ```
 
-Pilih agent, langsung generate config file dengan SOLID + SRP rules + palbox conventions.
+Select an agent to instantly generate its config file with SOLID + SRP rules + palbox knowledge graph conventions.
 
-### One-shot (tanpa install)
+### One-shot (without installing)
 ```bash
 npx palskills
 ```

package/bin/palskills.js

@@ -29,15 +29,15 @@ async function main() {
   box('PALSKILLS\nAI Development Pipeline');
 
   console.log('');
-  console.log(`  ${BOLD}Pilih coding agent:${NC}`);
+  console.log(`  ${BOLD}Select coding agent:${NC}`);
   console.log('');
   console.log(`  ${MAGENTA}[1]${NC} Codex CLI     → .codex.md`);
   console.log(`  ${MAGENTA}[2]${NC} Cursor        → .cursorrules`);
   console.log(`  ${MAGENTA}[3]${NC} Claude Code   → CLAUDE.md`);
-  console.log(`  ${MAGENTA}[4]${NC} Semua         → generate all`);
+  console.log(`  ${MAGENTA}[4]${NC} All           → generate all`);
   console.log('');
 
-  const choice = await ask(`  Pilih [1-4]: `);
+  const choice = await ask(`  Choose [1-4]: `);
   console.log('');
 
   const agents = [];
@@ -45,7 +45,7 @@ async function main() {
   else if (choice === '2') agents.push('cursor');
   else if (choice === '3') agents.push('claude');
   else if (choice === '4') agents.push('codex', 'cursor', 'claude');
-  else { console.log('  Pilihan tidak valid. Exit.'); process.exit(1); }
+  else { console.log('  Invalid choice. Exiting.'); process.exit(1); }
 
   for (const agent of agents) {
     generate(agent);
@@ -54,7 +54,7 @@ async function main() {
   // Also install Hermes skills
   installSkills();
 
-  console.log(`\n  ${GREEN}✅ Done!${NC} Restart Hermes Agent untuk load skills.\n`);
+  console.log(`\n  ${GREEN}✅ Done!${NC} Restart Hermes Agent to load skills.\n`);
 }
 
 function generate(agent) {
@@ -109,9 +109,22 @@ ALL code, comments, docstrings, variable names, and commit messages MUST be in E
 - One commit per logical change.
 - Conventional commits: feat(scope): description / fix(scope): description / test(scope): description
 
-## Palbox
-- Check .palbox/ for project context before starting.
-- Record results to .palbox/history/ after completion.
+## Palbox Knowledge Graph (CRITICAL)
+### Before you start ANY task
+1. **Check if `.palbox/` exists.** If not, the project hasn't been bootstrapped yet.
+2. **Read the core nodes:**
+   - `.palbox/README.md` — project identity, tech stack, goals
+   - `.palbox/architecture.md` — folder structure, design patterns, key modules
+   - `.palbox/methods.md` — coding conventions, testing strategy, git workflow
+3. **Search for related past work:**
+   - Search for keywords in `.palbox/flows/` and `.palbox/history/`
+   - Follow `[[wikilinks]]` to discover connected context
+4. **Read relevant flows** in `.palbox/flows/` — they document how features work end-to-end
+5. **Read relevant history** in `.palbox/history/` — past plans, executions, lessons learned
+
+### After you complete a task
+- Record what you did. The Palskills system (Panthalus) will create a `.palbox/history/YYYY-MM-DD-feature.md` node with `[[wikilinks]]` to related entries.
+- If you discovered new patterns, conventions, or pitfalls, note them — they enrich the graph.
 `;
 }
 
@@ -144,10 +157,17 @@ ALL code, comments, docs, variable names, and commit messages MUST be in English
 - One commit per logical change
 - Conventional commits format: feat(scope): / fix(scope): / test(scope):
 
-### Project Context
-- Check .palbox/ for architecture, conventions, and past work.
-- Read .palbox/README.md, .palbox/architecture.md, .palbox/methods.md before coding.
-- After completing work, the Palskills system will record to .palbox/history/.
+### Project Context — Palbox Knowledge Graph
+Before you start ANY task:
+1. **Check if `.palbox/` exists.** Read the core nodes:
+   - `.palbox/README.md` — project identity, stack, goals
+   - `.palbox/architecture.md` — folder structure, patterns, key modules
+   - `.palbox/methods.md` — conventions, testing, git workflow
+2. **Search `.palbox/flows/` and `.palbox/history/`** for related past work.
+3. **Follow `[[wikilinks]]`** — they connect related nodes in the knowledge graph.
+
+After completing work:
+- The Palskills system (Panthalus) records to `.palbox/history/` with bi-directional links.
 
 ### Code Quality
 - No file exceeds 200 lines without strong justification.
@@ -197,16 +217,18 @@ ALL code, comments, docstrings, variable names, function names, and commit messa
 - Conventional commits: feat(scope): / fix(scope): / test(scope):
 - Never commit generated files, node_modules, or secrets.
 
-## Project Context (Palbox)
+## Project Context — Palbox Knowledge Graph
 Before starting any task:
-1. Check if .palbox/ exists.
-2. Read .palbox/README.md for project overview.
-3. Read .palbox/architecture.md for folder structure and patterns.
-4. Read .palbox/methods.md for conventions.
-5. Search .palbox/history/ for related past work.
+1. Check if `.palbox/` exists. Read the core nodes:
+   - `.palbox/README.md` — project identity, stack, goals
+   - `.palbox/architecture.md` — folder structure, patterns, key modules
+   - `.palbox/methods.md` — conventions, testing, git workflow
+2. Search `.palbox/flows/` and `.palbox/history/` for related past work.
+3. Follow `[[wikilinks]]` — they connect related nodes in the knowledge graph.
 
 After completing work:
-- The Palskills system will record your session to .palbox/history/.
+- The Palskills system (Panthalus) records your session to `.palbox/history/` with bi-directional `[[wikilinks]]`.
+- If you discovered patterns, pitfalls, or conventions worth preserving, note them.
 `;
 }
 

package/install.js

@@ -0,0 +1,38 @@
+#!/usr/bin/env node
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+
+const GREEN = '\x1b[32m';
+const YELLOW = '\x1b[33m';
+const NC = '\x1b[0m';
+
+const hermesHome = process.env.HERMES_HOME || path.join(os.homedir(), '.hermes');
+const target = path.join(hermesHome, 'skills', 'palskills');
+const src = path.join(__dirname, '..', 'skills');
+
+console.log('╔══════════════════════════════════════╗');
+console.log('║     Palskills Installer             ║');
+console.log('╚══════════════════════════════════════╝');
+console.log('');
+
+if (!fs.existsSync(src)) {
+  console.log(`  ${YELLOW}⚠${NC}  Skills source not found. Skipping.`);
+  process.exit(0);
+}
+
+fs.mkdirSync(target, { recursive: true });
+
+const skills = fs.readdirSync(src);
+for (const skill of skills) {
+  const skillMd = path.join(src, skill, 'SKILL.md');
+  if (fs.existsSync(skillMd)) {
+    const dest = path.join(target, skill);
+    fs.mkdirSync(dest, { recursive: true });
+    fs.copyFileSync(skillMd, path.join(dest, 'SKILL.md'));
+    console.log(`  ${GREEN}✓${NC} ${skill}`);
+  }
+}
+
+console.log('');
+console.log(`  ${GREEN}✅ Done!${NC} Skills installed to ${target}`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "palskills",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "AI-powered development pipeline — 5 Hermes Agent skills orchestrated as a knowledge graph",
   "keywords": [
     "hermes-agent",
@@ -30,9 +30,9 @@
   "files": [
     "skills/",
     "bin/",
-    "install.sh"
+    "install.js"
   ],
   "scripts": {
-    "postinstall": "bash install.sh"
+    "postinstall": "node install.js"
   }
 }

package/install.sh

@@ -1,43 +0,0 @@
-#!/usr/bin/env bash
-set -euo pipefail
-
-HERMES_SKILLS="${HERMES_HOME:-$HOME/.hermes}/skills"
-TARGET="${HERMES_SKILLS}/palskills"
-
-echo "╔══════════════════════════════════════╗"
-echo "║     Palskills Installer             ║"
-echo "╚══════════════════════════════════════╝"
-echo ""
-
-# Check Hermes skills directory
-if [ ! -d "$HERMES_SKILLS" ]; then
-    echo "📁 Creating Hermes skills directory: $HERMES_SKILLS"
-    mkdir -p "$HERMES_SKILLS"
-fi
-
-# Install each skill
-SKILLS_DIR="$(cd "$(dirname "$0")" && pwd)/skills"
-
-for skill in astralym lyleen jetdragon anubis panthalus; do
-    if [ -f "$SKILLS_DIR/$skill/SKILL.md" ]; then
-        echo "📦 Installing: $skill"
-        mkdir -p "$TARGET/$skill"
-        cp "$SKILLS_DIR/$skill/SKILL.md" "$TARGET/$skill/SKILL.md"
-    else
-        echo "⚠️  Warning: $skill/SKILL.md not found, skipping"
-    fi
-done
-
-echo ""
-echo "✅ Palskills installed to: $TARGET"
-echo ""
-echo "Skills ready:"
-ls -1 "$TARGET"/*/SKILL.md | while read f; do
-    dir=$(basename "$(dirname "$f")")
-    echo "  • $dir"
-done
-echo ""
-echo "Usage: In Hermes Agent, invoke any skill by name:"
-echo "  - 'Load the astralym skill'"
-echo "  - 'Use lyleen to check palbox'"
-echo "  - 'Run jetdragon for planning'"