pmoskills 0.3.0 → 0.4.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.
- package/README.md +207 -0
- package/dist/index.js +1 -1
- package/dist/index.mjs +1 -1
- package/package.json +3 -2
package/README.md
ADDED
|
@@ -0,0 +1,207 @@
|
|
|
1
|
+
# pmoskills
|
|
2
|
+
|
|
3
|
+
[](https://www.npmjs.com/package/pmoskills)
|
|
4
|
+
[](https://www.npmjs.com/package/pmoskills)
|
|
5
|
+
[](../../LICENSE)
|
|
6
|
+
[](./tests/sdk.test.ts)
|
|
7
|
+
[](https://doi.org/10.5281/zenodo.20510540)
|
|
8
|
+
|
|
9
|
+
> **An executable skill system & PMO reference architecture built on PMI PMBOK® 8th Edition.**
|
|
10
|
+
> Zero dependencies · Dual ESM/CJS · TypeScript declarations · Edge & Browser compatible
|
|
11
|
+
|
|
12
|
+
---
|
|
13
|
+
|
|
14
|
+
## Installation
|
|
15
|
+
|
|
16
|
+
```bash
|
|
17
|
+
npm install pmoskills
|
|
18
|
+
# or
|
|
19
|
+
yarn add pmoskills
|
|
20
|
+
# or
|
|
21
|
+
pnpm add pmoskills
|
|
22
|
+
```
|
|
23
|
+
|
|
24
|
+
---
|
|
25
|
+
|
|
26
|
+
## Quick Start
|
|
27
|
+
|
|
28
|
+
```typescript
|
|
29
|
+
import { pmoskills, inject } from 'pmoskills';
|
|
30
|
+
|
|
31
|
+
// Get an executable skill definition
|
|
32
|
+
const skill = pmoskills.getSkill('SKL-01-01');
|
|
33
|
+
console.log(skill.title); // "Establish PM Governance Framework"
|
|
34
|
+
console.log(skill.domain); // "Governance"
|
|
35
|
+
console.log(skill.inputs); // ["Project Charter", ...]
|
|
36
|
+
|
|
37
|
+
// Inject variables into the skill's prompt template
|
|
38
|
+
const prompt = inject(skill.prompt, {
|
|
39
|
+
projectName: 'Apex Initiative',
|
|
40
|
+
authorityThreshold: '$100,000'
|
|
41
|
+
});
|
|
42
|
+
|
|
43
|
+
// Retrieve a deliverable template
|
|
44
|
+
const businessCase = pmoskills.getArtifact('A01');
|
|
45
|
+
console.log(businessCase.title); // "Business Case"
|
|
46
|
+
console.log(businessCase.category); // "Authorization"
|
|
47
|
+
|
|
48
|
+
// Query PMBOK 8 principles
|
|
49
|
+
const principle = pmoskills.getReferenceFile(
|
|
50
|
+
'reference/principles/P01-stewardship.md'
|
|
51
|
+
);
|
|
52
|
+
console.log(principle.title); // "Be a Diligent, Respectful, and Caring Steward"
|
|
53
|
+
```
|
|
54
|
+
|
|
55
|
+
---
|
|
56
|
+
|
|
57
|
+
## API Reference
|
|
58
|
+
|
|
59
|
+
### Executable Skills
|
|
60
|
+
|
|
61
|
+
```typescript
|
|
62
|
+
pmoskills.getSkills() // → ExecutableSkill[]
|
|
63
|
+
pmoskills.getSkill(id: string) // → ExecutableSkill | undefined
|
|
64
|
+
pmoskills.getSkillsByDomain(domain: string) // → ExecutableSkill[]
|
|
65
|
+
```
|
|
66
|
+
|
|
67
|
+
### PMBOK 8 Process Records
|
|
68
|
+
|
|
69
|
+
```typescript
|
|
70
|
+
pmoskills.getProcesses() // → ProcessRecord[]
|
|
71
|
+
pmoskills.getProcess(id: string) // → ProcessRecord | undefined
|
|
72
|
+
```
|
|
73
|
+
|
|
74
|
+
### Artifact Templates
|
|
75
|
+
|
|
76
|
+
```typescript
|
|
77
|
+
pmoskills.getArtifacts() // → ArtifactTemplate[]
|
|
78
|
+
pmoskills.getArtifact(id: string) // → ArtifactTemplate | undefined
|
|
79
|
+
```
|
|
80
|
+
|
|
81
|
+
### Reference Files (Principles, Domains, Focus Areas…)
|
|
82
|
+
|
|
83
|
+
```typescript
|
|
84
|
+
pmoskills.getReferenceFiles() // → ReferenceFile[]
|
|
85
|
+
pmoskills.getReferenceFile(path: string) // → ReferenceFile | undefined
|
|
86
|
+
```
|
|
87
|
+
|
|
88
|
+
### Shared Validators & Checklists
|
|
89
|
+
|
|
90
|
+
```typescript
|
|
91
|
+
pmoskills.getSharedFiles() // → SharedFile[]
|
|
92
|
+
pmoskills.getSharedFile(path: string) // → SharedFile | undefined
|
|
93
|
+
```
|
|
94
|
+
|
|
95
|
+
### Compliance & Skill Tests
|
|
96
|
+
|
|
97
|
+
```typescript
|
|
98
|
+
pmoskills.getTestFiles() // → TestFile[]
|
|
99
|
+
pmoskills.getTestFile(id: string) // → TestFile | undefined
|
|
100
|
+
```
|
|
101
|
+
|
|
102
|
+
### System Prompts & Ontology
|
|
103
|
+
|
|
104
|
+
```typescript
|
|
105
|
+
pmoskills.getSystemPrompt(key: string) // → SystemPrompt | undefined
|
|
106
|
+
pmoskills.getOntology() // → OntologySpec
|
|
107
|
+
```
|
|
108
|
+
|
|
109
|
+
### Prompt Template Injector
|
|
110
|
+
|
|
111
|
+
```typescript
|
|
112
|
+
import { inject } from 'pmoskills';
|
|
113
|
+
|
|
114
|
+
// Supports three placeholder formats:
|
|
115
|
+
inject(template, vars); // {{ var }}, [FIELD: var], [var]
|
|
116
|
+
```
|
|
117
|
+
|
|
118
|
+
---
|
|
119
|
+
|
|
120
|
+
## Corpus Summary
|
|
121
|
+
|
|
122
|
+
| Collection | Items | Method |
|
|
123
|
+
|---|:---:|---|
|
|
124
|
+
| Executable Skills | **48** | `getSkills()` / `getSkill(id)` |
|
|
125
|
+
| PMBOK 8 Process Records | **41** | `getProcesses()` / `getProcess(id)` |
|
|
126
|
+
| Artifact Templates | **92** | `getArtifacts()` / `getArtifact(id)` |
|
|
127
|
+
| Reference Files | **97** | `getReferenceFiles()` / `getReferenceFile(path)` |
|
|
128
|
+
| Shared Validators & Checklists | **28** | `getSharedFiles()` / `getSharedFile(path)` |
|
|
129
|
+
| Compliance Test Scenarios | **59** | `getTestFiles()` / `getTestFile(id)` |
|
|
130
|
+
| System Prompts | **4** | `getSystemPrompt(key)` |
|
|
131
|
+
| **Total Corpus Items** | **369+** | |
|
|
132
|
+
|
|
133
|
+
---
|
|
134
|
+
|
|
135
|
+
## Architecture
|
|
136
|
+
|
|
137
|
+
```
|
|
138
|
+
sdk/
|
|
139
|
+
├── src/
|
|
140
|
+
│ ├── index.ts ← Public API surface
|
|
141
|
+
│ ├── core/
|
|
142
|
+
│ │ ├── loader.ts ← PMOSkillsLoader singleton (pmoskills)
|
|
143
|
+
│ │ └── injector.ts ← Multi-format prompt template injector
|
|
144
|
+
│ ├── types/
|
|
145
|
+
│ │ └── index.ts ← TypeScript interfaces for all collections
|
|
146
|
+
│ └── db/
|
|
147
|
+
│ └── store.json ← Pre-compiled corpus (auto-generated at build time)
|
|
148
|
+
├── scripts/
|
|
149
|
+
│ └── compile-db.ts ← Build-time corpus compiler (reads entire repo)
|
|
150
|
+
├── tests/
|
|
151
|
+
│ └── sdk.test.ts ← Vitest unit tests (18 tests, 100% pass rate)
|
|
152
|
+
└── dist/
|
|
153
|
+
├── index.js ← CommonJS bundle
|
|
154
|
+
└── index.mjs ← ES Module bundle
|
|
155
|
+
```
|
|
156
|
+
|
|
157
|
+
### Zero-FS Architecture
|
|
158
|
+
|
|
159
|
+
All corpus data is serialized into `src/db/store.json` **at build time** by `scripts/compile-db.ts`. The compiled bundles (`dist/index.js` and `dist/index.mjs`) contain the entire corpus inline — no file-system access is performed at runtime.
|
|
160
|
+
|
|
161
|
+
This makes the package compatible with:
|
|
162
|
+
- ✅ Node.js (any version)
|
|
163
|
+
- ✅ Cloudflare Workers
|
|
164
|
+
- ✅ Vercel Edge Functions
|
|
165
|
+
- ✅ Browser (via bundlers like Vite, Webpack)
|
|
166
|
+
- ✅ Deno (via npm compatibility)
|
|
167
|
+
|
|
168
|
+
---
|
|
169
|
+
|
|
170
|
+
## Building Locally
|
|
171
|
+
|
|
172
|
+
```bash
|
|
173
|
+
# Install dependencies
|
|
174
|
+
npm install
|
|
175
|
+
|
|
176
|
+
# Compile corpus + build dual CJS/ESM bundles
|
|
177
|
+
npm run build
|
|
178
|
+
|
|
179
|
+
# Run unit tests
|
|
180
|
+
npm test
|
|
181
|
+
```
|
|
182
|
+
|
|
183
|
+
---
|
|
184
|
+
|
|
185
|
+
## Citation
|
|
186
|
+
|
|
187
|
+
```bibtex
|
|
188
|
+
@misc{pmoskills2026,
|
|
189
|
+
author = {Fakhruldeen, Mohamed Fouad},
|
|
190
|
+
title = {{PMOSkills: An Executable Skill System \& PMO Reference Architecture
|
|
191
|
+
built on PMI PMBOK® 8th Edition}},
|
|
192
|
+
month = jun,
|
|
193
|
+
year = 2026,
|
|
194
|
+
publisher = {Zenodo},
|
|
195
|
+
version = {v0.4},
|
|
196
|
+
doi = {10.5281/zenodo.20510540},
|
|
197
|
+
url = {https://doi.org/10.5281/zenodo.20510540}
|
|
198
|
+
}
|
|
199
|
+
```
|
|
200
|
+
|
|
201
|
+
---
|
|
202
|
+
|
|
203
|
+
## License
|
|
204
|
+
|
|
205
|
+
MIT © [Mohamed Fouad Fakhruldeen](https://fakhruldeen.me)
|
|
206
|
+
|
|
207
|
+
*PMBOK® is a registered trademark of the Project Management Institute, Inc. This project is independently developed and is not affiliated with or endorsed by PMI.*
|
package/dist/index.js
CHANGED
|
@@ -4489,7 +4489,7 @@ var ontology = {
|
|
|
4489
4489
|
content: "# 🧠 PMOSkills Knowledge Graph & Ontology Specification\n\nThis document provides the authoritative ontological specifications and semantic relationships governing the files in the **PMOSkills Reference Architecture**. It is designed explicitly for **AI Agents**, LLM parsers, knowledge graph builders, and developer tools to programmatically parse and navigate the repository.\n\n---\n\n## 1. Ontological Node Types (Entity Classes)\n\nThe PMOSkills repository is modeled as a directed, acyclic semantic graph consisting of five core entity classes:\n\n```\n ┌────────────────────────────────────────────────────────────────────────┐\n │ PMOSkills │\n └───────────────────┬─────────────────────────────────┬──────────────────┘\n │ │\n ▼ ▼\n ┌────────────────────────┐ ┌────────────────────────┐\n │ Reference Layer │ │ Skills Layer │\n └────────────┬───────────┘ └────────────┬───────────┘\n │ │\n ▼ ▼\n ┌────────────────────────┐ ┌────────────────────────┐\n │ Artifact Layer │ │ Testing Layer │\n └────────────────────────┘ └────────────────────────┘\n```\n\n1. **`Principle` (P01-P12):** Core philosophical standards guiding behavior.\n2. **`PerformanceDomain` (PD01-PD08):** Broad operational performance fields.\n3. **`ProcessRecord` (PR01-PR41):** Formal project management process definitions.\n4. **`ExecutableSkill` (SKL-XX-YY):** Step-by-step procedural action manuals.\n5. **`ArtifactTemplate` (A01-A39):** Machine-parsable, placeholder-driven project deliverables.\n6. **`Testcase` (TST-XX-YY):** Programmatic QA tests validating skills and artifacts.\n\n---\n\n## 2. Relationship Schemas (Edges)\n\nNodes are linked by strict, deterministic semantic edges:\n\n| Subject Node | Relationship (Edge) | Object Node | Description |\n|---|---|---|---|\n| `ProcessRecord` | `MAPS_TO` | `PerformanceDomain` | Maps a process to its PMBOK 8 operational domain. |\n| `ExecutableSkill` | `IMPLEMENTS` | `ProcessRecord` | Maps a skill to its defining standard process. |\n| `ExecutableSkill` | `OUTPUTS` | `ArtifactTemplate` | Declares the mandatory template produced by a skill. |\n| `ArtifactTemplate` | `VALIDATES` | `ProcessRecord` | Connects a deliverable template back to standard process compliance. |\n| `Testcase` | `VERIFIES` | `ExecutableSkill` | Programmatic unit tests validating skill execution logs. |\n\n---\n\n## 3. Strict GOV Front-Matter Metadata Properties\n\nEvery markdown document in the repository must contain a valid YAML front-matter block at the absolute beginning of the file. AI agents must parse and validate these properties:\n\n### 3.1 Executable Skill (`skills/`) YAML Specifications\n```yaml\n---\nskill_id: SKL-03-03\nskill_name: \"Create Work Breakdown Structure (WBS)\"\npack: \"Pack 03: Planning\"\nversion: \"1.0.0\"\nstatus: Active\npmo_level: \"T2 Controlled\"\ninputs:\n - \"docs/human-practitioners/tailoring-guide.md\"\n - \"artifacts/initiating/A04-project-charter-template.md\"\noutputs:\n - \"artifacts/planning-and-baselines/A09-work-breakdown-structure-template.md\"\n - \"artifacts/planning-and-baselines/A10-wbs-dictionary-template.md\"\npmbok8_align:\n - \"PR07: Create WBS\"\n - \"PD03: Planning\"\n---\n```\n\n### 3.2 Artifact Template (`artifacts/`) YAML Specifications\n```yaml\n---\nartifact_id: A09\nartifact_name: \"Work Breakdown Structure Record\"\ncategory: \"Planning & Baselines\"\nversion: \"1.0.0\"\nstatus: Template\nproject_id: \"PMO-TEMPLATE\"\npmbok8_align:\n - \"PR07: Create WBS\"\n - \"PD03: Planning\"\n---\n```\n\n---\n\n## 4. Parser Directives for AI Graph Traversers\n\nAI crawlers navigating this repository should follow these traversal protocols:\n\n### 4.1 Upward Traceability Traversal\n* **Goal:** Trace a modified artifact template back to its source PMBOK 8 standard.\n* **Protocol:**\n 1. Read `artifacts/AXX.md` front-matter properties to identify `pmbok8_align` values.\n 2. Locate `reference/processes/PRXX.md` to review the standard process input/output definitions.\n 3. Confirm alignment by reviewing the corresponding principle `reference/principles/PXX.md`.\n\n### 4.2 Downward Verification Traversal\n* **Goal:** Verify that a standard process change is fully integrated.\n* **Protocol:**\n 1. Read `reference/processes/PRXX.md`.\n 2. Query `skills/` for any skill matching `pmbok8_align: PRXX`.\n 3. Verify the skill outputs the expected `AXX` template.\n 4. Run unit tests `tests/` mapping `TST-XX` to confirm programmatic compliance.\n\n---\n\n*Authority: PMBOK 8 Core Schema Standard · PMO Shared Governance Board · AI Ontologies Council*"
|
|
4490
4490
|
};
|
|
4491
4491
|
var version = "0.3.0";
|
|
4492
|
-
var compiledAt = "2026-06-
|
|
4492
|
+
var compiledAt = "2026-06-02T14:18:11.378Z";
|
|
4493
4493
|
var storeData = {
|
|
4494
4494
|
skills: skills,
|
|
4495
4495
|
processes: processes,
|
package/dist/index.mjs
CHANGED
|
@@ -4485,7 +4485,7 @@ var ontology = {
|
|
|
4485
4485
|
content: "# 🧠 PMOSkills Knowledge Graph & Ontology Specification\n\nThis document provides the authoritative ontological specifications and semantic relationships governing the files in the **PMOSkills Reference Architecture**. It is designed explicitly for **AI Agents**, LLM parsers, knowledge graph builders, and developer tools to programmatically parse and navigate the repository.\n\n---\n\n## 1. Ontological Node Types (Entity Classes)\n\nThe PMOSkills repository is modeled as a directed, acyclic semantic graph consisting of five core entity classes:\n\n```\n ┌────────────────────────────────────────────────────────────────────────┐\n │ PMOSkills │\n └───────────────────┬─────────────────────────────────┬──────────────────┘\n │ │\n ▼ ▼\n ┌────────────────────────┐ ┌────────────────────────┐\n │ Reference Layer │ │ Skills Layer │\n └────────────┬───────────┘ └────────────┬───────────┘\n │ │\n ▼ ▼\n ┌────────────────────────┐ ┌────────────────────────┐\n │ Artifact Layer │ │ Testing Layer │\n └────────────────────────┘ └────────────────────────┘\n```\n\n1. **`Principle` (P01-P12):** Core philosophical standards guiding behavior.\n2. **`PerformanceDomain` (PD01-PD08):** Broad operational performance fields.\n3. **`ProcessRecord` (PR01-PR41):** Formal project management process definitions.\n4. **`ExecutableSkill` (SKL-XX-YY):** Step-by-step procedural action manuals.\n5. **`ArtifactTemplate` (A01-A39):** Machine-parsable, placeholder-driven project deliverables.\n6. **`Testcase` (TST-XX-YY):** Programmatic QA tests validating skills and artifacts.\n\n---\n\n## 2. Relationship Schemas (Edges)\n\nNodes are linked by strict, deterministic semantic edges:\n\n| Subject Node | Relationship (Edge) | Object Node | Description |\n|---|---|---|---|\n| `ProcessRecord` | `MAPS_TO` | `PerformanceDomain` | Maps a process to its PMBOK 8 operational domain. |\n| `ExecutableSkill` | `IMPLEMENTS` | `ProcessRecord` | Maps a skill to its defining standard process. |\n| `ExecutableSkill` | `OUTPUTS` | `ArtifactTemplate` | Declares the mandatory template produced by a skill. |\n| `ArtifactTemplate` | `VALIDATES` | `ProcessRecord` | Connects a deliverable template back to standard process compliance. |\n| `Testcase` | `VERIFIES` | `ExecutableSkill` | Programmatic unit tests validating skill execution logs. |\n\n---\n\n## 3. Strict GOV Front-Matter Metadata Properties\n\nEvery markdown document in the repository must contain a valid YAML front-matter block at the absolute beginning of the file. AI agents must parse and validate these properties:\n\n### 3.1 Executable Skill (`skills/`) YAML Specifications\n```yaml\n---\nskill_id: SKL-03-03\nskill_name: \"Create Work Breakdown Structure (WBS)\"\npack: \"Pack 03: Planning\"\nversion: \"1.0.0\"\nstatus: Active\npmo_level: \"T2 Controlled\"\ninputs:\n - \"docs/human-practitioners/tailoring-guide.md\"\n - \"artifacts/initiating/A04-project-charter-template.md\"\noutputs:\n - \"artifacts/planning-and-baselines/A09-work-breakdown-structure-template.md\"\n - \"artifacts/planning-and-baselines/A10-wbs-dictionary-template.md\"\npmbok8_align:\n - \"PR07: Create WBS\"\n - \"PD03: Planning\"\n---\n```\n\n### 3.2 Artifact Template (`artifacts/`) YAML Specifications\n```yaml\n---\nartifact_id: A09\nartifact_name: \"Work Breakdown Structure Record\"\ncategory: \"Planning & Baselines\"\nversion: \"1.0.0\"\nstatus: Template\nproject_id: \"PMO-TEMPLATE\"\npmbok8_align:\n - \"PR07: Create WBS\"\n - \"PD03: Planning\"\n---\n```\n\n---\n\n## 4. Parser Directives for AI Graph Traversers\n\nAI crawlers navigating this repository should follow these traversal protocols:\n\n### 4.1 Upward Traceability Traversal\n* **Goal:** Trace a modified artifact template back to its source PMBOK 8 standard.\n* **Protocol:**\n 1. Read `artifacts/AXX.md` front-matter properties to identify `pmbok8_align` values.\n 2. Locate `reference/processes/PRXX.md` to review the standard process input/output definitions.\n 3. Confirm alignment by reviewing the corresponding principle `reference/principles/PXX.md`.\n\n### 4.2 Downward Verification Traversal\n* **Goal:** Verify that a standard process change is fully integrated.\n* **Protocol:**\n 1. Read `reference/processes/PRXX.md`.\n 2. Query `skills/` for any skill matching `pmbok8_align: PRXX`.\n 3. Verify the skill outputs the expected `AXX` template.\n 4. Run unit tests `tests/` mapping `TST-XX` to confirm programmatic compliance.\n\n---\n\n*Authority: PMBOK 8 Core Schema Standard · PMO Shared Governance Board · AI Ontologies Council*"
|
|
4486
4486
|
};
|
|
4487
4487
|
var version = "0.3.0";
|
|
4488
|
-
var compiledAt = "2026-06-
|
|
4488
|
+
var compiledAt = "2026-06-02T14:18:11.378Z";
|
|
4489
4489
|
var storeData = {
|
|
4490
4490
|
skills: skills,
|
|
4491
4491
|
processes: processes,
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "pmoskills",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.4.0",
|
|
4
4
|
"description": "An executable skill system & PMO reference architecture built on PMI PMBOK® 8th Edition",
|
|
5
5
|
"main": "./dist/index.js",
|
|
6
6
|
"module": "./dist/index.mjs",
|
|
@@ -13,7 +13,8 @@
|
|
|
13
13
|
}
|
|
14
14
|
},
|
|
15
15
|
"files": [
|
|
16
|
-
"dist"
|
|
16
|
+
"dist",
|
|
17
|
+
"README.md"
|
|
17
18
|
],
|
|
18
19
|
"scripts": {
|
|
19
20
|
"compile-db": "ts-node scripts/compile-db.ts",
|