@esoteric-logic/praxis-harness 3.1.2 → 3.2.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.
@@ -39,13 +39,17 @@ Do NOT show "Work on praxis" or "Work on maximus" or any project name — the en
39
39
 
40
40
  Platform outputs use suffixed filenames so users can distinguish them at a glance:
41
41
 
42
- | Platform | Output Filename | Budget |
43
- |----------|----------------|--------|
44
- | Source (Claude Projects) | `system-prompt.md` | 5,000 chars |
45
- | Claude Desktop / Projects | `project-instructions-claude-desktop.md` | 2,500 chars |
46
- | Perplexity Spaces | `space-instructions-perplexity.md` | 4,000 chars |
42
+ | Platform | Output Filename | Budget | When |
43
+ |----------|----------------|--------|------|
44
+ | Claude Projects | `system-prompt.md` | 5,000 chars | Standalone projects |
45
+ | Claude Projects | `project-instructions-claude-desktop.md` | 2,500 chars | Compiled projects (compiler output) |
46
+ | Perplexity Spaces | `space-instructions-perplexity.md` | 4,000 chars | All projects |
47
47
 
48
- Claude Code `CLAUDE.md` is NOT generated by this skill use `px-scaffold` for repo-level CLAUDE.md files.
48
+ Each project has exactly **2 output files** one for Claude Projects, one for Perplexity Spaces.
49
+ - Standalone: `system-prompt.md` + `space-instructions-perplexity.md`
50
+ - Compiled: `project-instructions-claude-desktop.md` + `space-instructions-perplexity.md`
51
+
52
+ Claude Code `CLAUDE.md` is NOT generated by this skill — use `px-scaffold`.
49
53
 
50
54
  All output files live in the project's folder under `prompts/work/` or `prompts/personal/`.
51
55
  Reference/knowledge files live in `<project>/references/`.
@@ -361,7 +365,7 @@ For each research domain:
361
365
 
362
366
  ## Step 3 — CONDENSE: Generate platform outputs from system-prompt.md
363
367
 
364
- **Triggered when:** standalone project has `system-prompt.md` but missing `space-instructions-perplexity.md` or `project-instructions-claude-desktop.md`.
368
+ **Triggered when:** standalone project has `system-prompt.md` but missing `space-instructions-perplexity.md`.
365
369
 
366
370
  Read the full `system-prompt.md` as source.
367
371
 
@@ -408,18 +412,11 @@ Think step-by-step: Understand the question → search sources → analyze findi
408
412
  - Replace absolute language with conditional ("if available", "when sources confirm")
409
413
  - Search-friendly domain terms
410
414
 
411
- ### 3b. Generate Claude Desktop project instructions (if Claude Projects is a target platform)
412
-
413
- **Target:** `project-instructions-claude-desktop.md` | **Budget:** under 2,500 chars
414
-
415
- **Include:** role, behavioral constraints, domain expertise (condensed), output format, quality controls, when uncertain
416
- **Exclude:** full domain details (those go in knowledge files), reference content, deployment details
417
-
418
- ### 3c. Validate budgets
415
+ ### 3b. Validate budgets
419
416
 
420
417
  After generating, check:
418
+ - `system-prompt.md` under 5,000 chars
421
419
  - `space-instructions-perplexity.md` under 4,000 chars
422
- - `project-instructions-claude-desktop.md` under 2,500 chars
423
420
 
424
421
  If over budget: flag and suggest sections to trim.
425
422
 
@@ -442,7 +439,6 @@ node bin/prompt-compile.js <project-name>
442
439
  | Output | Chars | Budget | Status |
443
440
  |------------------------------------------|--------|--------|--------|
444
441
  | system-prompt.md | X | 5,000 | Source |
445
- | project-instructions-claude-desktop.md | X | 2,500 | OK |
446
442
  | space-instructions-perplexity.md | X | 4,000 | OK |
447
443
  | references/ | N files| — | Upload |
448
444
  ```
@@ -451,7 +447,7 @@ node bin/prompt-compile.js <project-name>
451
447
 
452
448
  **Claude Desktop / Projects (claude.ai):**
453
449
  1. Open project at claude.ai/projects → "Set project instructions"
454
- 2. Standalone: paste `system-prompt.md` | Compiled: paste `project-instructions-claude-desktop.md`
450
+ 2. Paste `system-prompt.md` (standalone) or `project-instructions-claude-desktop.md` (compiled)
455
451
  3. If `references/` exists: upload each `.md` file as project knowledge
456
452
  4. Save
457
453
 
@@ -497,7 +493,7 @@ Print deployment reminders for any project with changes.
497
493
  ### 6a. Read all project files
498
494
  1. Read `prompt-config.yaml` for project metadata
499
495
  2. Read `system-prompt.md` (source of truth)
500
- 3. Read all platform outputs (`space-instructions-perplexity.md`, `project-instructions-claude-desktop.md`)
496
+ 3. Read platform outputs (`system-prompt.md` or `project-instructions-claude-desktop.md`, `space-instructions-perplexity.md`)
501
497
  4. Read all files in `references/` directory
502
498
  5. List any other files in the project folder
503
499
 
@@ -513,8 +509,9 @@ Check each file against these criteria:
513
509
  - Are all referenced knowledge files present in references/?
514
510
 
515
511
  **Budget checks:**
512
+ - `system-prompt.md` under 5,000 chars? (standalone)
513
+ - `project-instructions-claude-desktop.md` under 2,500 chars? (compiled)
516
514
  - `space-instructions-perplexity.md` under 4,000 chars?
517
- - `project-instructions-claude-desktop.md` under 2,500 chars?
518
515
 
519
516
  **Currency checks (via Perplexity):**
520
517
  - Are domain-specific terms, standards, and versions still current?
@@ -740,7 +737,7 @@ Maximus PP: 2 contracts at IRS (from USASpending)
740
737
  Gaps: Key personnel [RESEARCH NEEDED]
741
738
  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
742
739
  Files created:
743
- ✓ project-instructions-claude-desktop.md (2,480 chars)
740
+ ✓ project-instructions-claude-desktop.md (2,480 chars) — compiled from profile
744
741
  ✓ space-instructions-perplexity.md (3,976 chars) — deal-specific research domains
745
742
  ✓ references/irs-masterfile-intel.md
746
743
  ✓ knowledge/deal-context.md
@@ -827,7 +824,7 @@ EDIT APPLIED
827
824
  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
828
825
  Changed: <file(s) modified>
829
826
  Regenerated: <platform outputs updated>
830
- Budget: perplexity ✓ | claude-desktop
827
+ Budget: claude-projects ✓ | perplexity
831
828
  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
832
829
  ```
833
830
 
@@ -933,11 +930,10 @@ Determine which platforms are targets from `prompt-config.yaml`.
933
930
  ### 11b. Deploy sequence (per platform)
934
931
 
935
932
  **For Claude Projects / Desktop:**
936
- 1. Read `system-prompt.md` (standalone) or `project-instructions-claude-desktop.md` (compiled)
937
- 2. Copy content to clipboard: `cat <file> | pbcopy`
933
+ 1. Determine file: `system-prompt.md` (standalone) or `project-instructions-claude-desktop.md` (compiled)
934
+ 2. Copy to clipboard: `cat <file> | pbcopy`
938
935
  3. Print: "Copied to clipboard. Paste at: claude.ai/projects → Set project instructions"
939
936
  4. List knowledge files to upload: all `.md` files from `references/` AND `knowledge/`
940
- 5. Print upload instructions: "Upload these as project knowledge files (drag & drop):"
941
937
 
942
938
  **For Perplexity Spaces:**
943
939
  1. Read `space-instructions-perplexity.md`
@@ -1106,8 +1102,9 @@ NEXT GATE CHECKLIST: Pre-Proposal
1106
1102
  - **Claude Code CLAUDE.md**: NOT generated by px-prompt — use px-scaffold
1107
1103
 
1108
1104
  ### File naming
1109
- - **Always** use platform-suffixed filenames: `space-instructions-perplexity.md`, `project-instructions-claude-desktop.md`
1110
- - `system-prompt.md` keeps its name (it's the source of truth, not platform-specific)
1105
+ - Standalone Claude Projects output: `system-prompt.md`
1106
+ - Compiled Claude Projects output: `project-instructions-claude-desktop.md`
1107
+ - Perplexity output: `space-instructions-perplexity.md`
1111
1108
 
1112
1109
  ### Quality defaults (mandatory in all generated prompts)
1113
1110
  - Anti-Hallucination Protocol: never fabricate, cite sources, flag confidence, distinguish fact from inference
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@esoteric-logic/praxis-harness",
3
- "version": "3.1.2",
3
+ "version": "3.2.0",
4
4
  "description": "Layered Claude Code harness — workflow discipline, AI-Kits, persistent vault integration",
5
5
  "bin": {
6
6
  "praxis-harness": "./bin/praxis.js",
@@ -1,32 +0,0 @@
1
- ## Role
2
- Solutions architect supporting ECS Limited's Azure Zero Trust security engagement. Brownfield Azure environment (50-100+ apps, 50-100 VMs) targeting SOC 2 Type 2 and ISO 27001:2022 readiness.
3
-
4
- ## Engagement Context
5
- 3-phase contractor engagement: Discovery → Zero Trust Implementation → Future Architecture. 93 checklist items (84 contractor, 9 internal). No hard compliance deadline.
6
-
7
- ## Behavioral Constraints
8
- - Lead with recommendations and rationale, not options lists
9
- - Verify claims against the engagement SOW and knowledge files before presenting as fact
10
- - When uncertain, ask one clarifying question. Flag confidence: HIGH / MEDIUM / LOW
11
-
12
- ## Domain Expertise
13
- - Tiered network: User → Web → App/API → Data (deny-all default, no direct backend access)
14
- - Uncontrolled device model: all devices untrusted, no compliance gates. PAW for admin only.
15
- - Environment parity: dev = staging = prod for all security controls
16
- - Azure stack: Entra ID, Conditional Access, PIM, Firewall, NSGs, Private Link, Sentinel, Defender, Key Vault
17
- - SOC 2 TSC (2017/2022), ISO 27001:2022
18
- - 6 critical risks: R-01 (segmentation outages), R-05 (trusted client apps), R-07 (env parity), R-22 (dev adaptation), R-26 (client disruption), R-28 (no detection during transition)
19
-
20
- ## Output Format
21
- - Tables for control mappings, gap analyses, risk assessments
22
- - Map to 93-item engagement checklist where applicable
23
- - BLUF structure: bottom line, evidence, next steps
24
-
25
- ## Quality Controls
26
- - Cross-reference SOW and knowledge files. Flag contradictions.
27
- - Never fabricate version numbers, dates, statistics, or citations
28
- - Cite specific TSC criteria and ISO controls by reference
29
- - Flag information older than 12 months
30
-
31
- ## When Uncertain
32
- State uncertainty explicitly. Flag confidence: HIGH (verified), MEDIUM (corroborated), LOW (inferred).