@esoteric-logic/praxis-harness 3.1.1 → 3.1.2

package/base/skills/px-prompt/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: px-prompt
 disable-model-invocation: true
-description: "Unified prompt engine. Creates, generates, condenses, and syncs system prompts for Claude Projects, Perplexity Spaces, and Claude Code. Auto-detects what to do based on project state."
+description: "Unified prompt engine. Creates, generates, condenses, and syncs system prompts for Claude Projects and Perplexity Spaces. Auto-detects what to do based on project state. Claude Code CLAUDE.md is handled by px-scaffold."
 ---
 
 # px-prompt Skill
@@ -44,10 +44,11 @@ Platform outputs use suffixed filenames so users can distinguish them at a glanc
 | Source (Claude Projects) | `system-prompt.md` | 5,000 chars |
 | Claude Desktop / Projects | `project-instructions-claude-desktop.md` | 2,500 chars |
 | Perplexity Spaces | `space-instructions-perplexity.md` | 4,000 chars |
-| Claude Code | `CLAUDE.md` | 250 lines |
 
-All output files live in `prompts/projects/<project-name>/`.
-Reference/knowledge files live in `prompts/projects/<project-name>/references/`.
+Claude Code `CLAUDE.md` is NOT generated by this skill — use `px-scaffold` for repo-level CLAUDE.md files.
+
+All output files live in the project's folder under `prompts/work/` or `prompts/personal/`.
+Reference/knowledge files live in `<project>/references/`.
 
 ---
 
@@ -130,8 +131,8 @@ Run these rules against the description to auto-populate the project config:
 
 **Platform inference:**
 - Default: Claude Projects + Perplexity Spaces
-- Add Claude Code if description contains: "code", "repo", "implement", "build", "develop", "engineering", "CLI"
 - Perplexity-only if description contains: "research only", "analysis only", "investigation"
+- Claude Code CLAUDE.md is NOT a px-prompt output — use px-scaffold for that
 
 **Mode inference:**
 - If description triggers `maximus-sa` profile → compiled with `maximus-sa`
@@ -183,7 +184,6 @@ After confirmation:
 
 **Auto-add context blocks by platform (compiled mode):**
 - Perplexity → `official-docs-first`, `flag-confidence`
-- Claude Code → `vault-integration`, `mcp-servers`, `praxis-workflow`
 
 ---
 
@@ -361,7 +361,7 @@ For each research domain:
 
 ## Step 3 — CONDENSE: Generate platform outputs from system-prompt.md
 
-**Triggered when:** standalone project has `system-prompt.md` but missing `space-instructions-perplexity.md` or `CLAUDE.md`.
+**Triggered when:** standalone project has `system-prompt.md` but missing `space-instructions-perplexity.md` or `project-instructions-claude-desktop.md`.
 
 Read the full `system-prompt.md` as source.
 
@@ -408,44 +408,18 @@ Think step-by-step: Understand the question → search sources → analyze findi
 - Replace absolute language with conditional ("if available", "when sources confirm")
 - Search-friendly domain terms
 
-### 3b. Generate Claude Code CLAUDE.md (if Claude Code is a target platform)
-
-**Target:** `CLAUDE.md` | **Budget:** under 250 lines
-
-**Include:** identity, behaviors, domain expertise, frameworks (one-line each), operating modes, quality controls, anti-hallucination rules
-**Exclude:** full scoring matrices, templates, reference file content, corporate data tables
-
-**Output format:**
-```markdown
-# [Project Name]
-## Identity
-## Behaviors
-## Domain Expertise
-## Frameworks
-## Operating Modes
-## Quality Controls
-## References
-```
-
-**Claude Code guardrails:**
-- Positive framing: "Do X" over "Don't do Y"
-- No "CRITICAL: YOU MUST" language (Claude 4.6 overtriggers)
-- Self-check block for quality-critical outputs
-- Reference knowledge files by filename only
-
-### 3c. Generate Claude Desktop project instructions (if Claude Projects is a target platform)
+### 3b. Generate Claude Desktop project instructions (if Claude Projects is a target platform)
 
 **Target:** `project-instructions-claude-desktop.md` | **Budget:** under 2,500 chars
 
 **Include:** role, behavioral constraints, domain expertise (condensed), output format, quality controls, when uncertain
 **Exclude:** full domain details (those go in knowledge files), reference content, deployment details
 
-### 3d. Validate budgets
+### 3c. Validate budgets
 
 After generating, check:
 - `space-instructions-perplexity.md` under 4,000 chars
 - `project-instructions-claude-desktop.md` under 2,500 chars
-- `CLAUDE.md` under 250 lines
 
 If over budget: flag and suggest sections to trim.
 
@@ -467,10 +441,9 @@ node bin/prompt-compile.js <project-name>
 ```
 | Output                                   | Chars  | Budget | Status |
 |------------------------------------------|--------|--------|--------|
-| system-prompt.md                         | X      | —      | Source |
+| system-prompt.md                         | X      | 5,000  | Source |
 | project-instructions-claude-desktop.md   | X      | 2,500  | OK     |
 | space-instructions-perplexity.md         | X      | 4,000  | OK     |
-| CLAUDE.md                                | X lines| 250 ln | OK     |
 | references/                              | N files| —      | Upload |
 ```
 
@@ -487,9 +460,6 @@ node bin/prompt-compile.js <project-name>
 2. Paste `space-instructions-perplexity.md`
 3. Save
 
-**Claude Code:**
-1. Copy `CLAUDE.md` to project repo root
-
 ### 4d. Offer next actions
 - "Edit the prompt? I'll regenerate platform outputs after."
 - "Want to regenerate? Run `/px-prompt <project-name>` again."
@@ -508,10 +478,10 @@ node bin/prompt-compile.js --all --diff
 
 Show summary table:
 ```
-| Project      | CLAUDE.md | Claude Desktop    | Perplexity       | Changes    |
-|--------------|-----------|-------------------|------------------|------------|
-| praxis       | 3,534     | 1,316 ✓           | 1,529 ✓          | none       |
-| maximus      | —         | —                 | 3,977 ✓          | standalone |
+| Project      | Claude Desktop    | Perplexity       | Changes    |
+|--------------|-------------------|------------------|------------|
+| praxis       | 1,316 ✓           | 1,529 ✓          | none       |
+| maximus      | —                 | 3,977 ✓          | standalone |
 ```
 
 For standalone projects, report validation status instead of compilation status.
@@ -527,7 +497,7 @@ Print deployment reminders for any project with changes.
 ### 6a. Read all project files
 1. Read `prompt-config.yaml` for project metadata
 2. Read `system-prompt.md` (source of truth)
-3. Read all platform outputs (`space-instructions-perplexity.md`, `project-instructions-claude-desktop.md`, `CLAUDE.md`)
+3. Read all platform outputs (`space-instructions-perplexity.md`, `project-instructions-claude-desktop.md`)
 4. Read all files in `references/` directory
 5. List any other files in the project folder
 
@@ -545,7 +515,6 @@ Check each file against these criteria:
 **Budget checks:**
 - `space-instructions-perplexity.md` under 4,000 chars?
 - `project-instructions-claude-desktop.md` under 2,500 chars?
-- `CLAUDE.md` under 250 lines?
 
 **Currency checks (via Perplexity):**
 - Are domain-specific terms, standards, and versions still current?
@@ -771,7 +740,7 @@ Maximus PP:  2 contracts at IRS (from USASpending)
 Gaps:        Key personnel [RESEARCH NEEDED]
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 Files created:
-  ✓ CLAUDE.md (31,646 chars)
+  ✓ project-instructions-claude-desktop.md (2,480 chars)
   ✓ space-instructions-perplexity.md (3,976 chars) — deal-specific research domains
   ✓ references/irs-masterfile-intel.md
   ✓ knowledge/deal-context.md
@@ -858,7 +827,7 @@ EDIT APPLIED
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 Changed: <file(s) modified>
 Regenerated: <platform outputs updated>
-Budget: perplexity ✓ | claude-desktop ✓ | CLAUDE.md ✓
+Budget: perplexity ✓ | claude-desktop ✓
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 ```
 
@@ -884,11 +853,11 @@ node bin/prompt-compile.js --dashboard
 ```
 PROMPT ENGINE DASHBOARD
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-Project       Mode       Perplexity    Claude Proj   CLAUDE.md   Refs  Updated     Stale?
-─────────────────────────────────────────────────────────────────────────────────────────
-maximus       compiled   3,976 ✓       4,261 ⚠       30,665 ✓    4     2026-04-04  No
-elect-azure   standalone 2,392 ✓       —             3,098 ✓     0     2026-04-04  No
-praxis        compiled   1,626 ✓       1,404 ✓       3,417 ✓     0     2026-04-04  No
+Project       Mode       Claude Desktop  Perplexity    Refs  Updated     Stale?
+──────────────────────────────────────────────────────────────────────────────
+maximus       compiled   4,261 ⚠        3,976 ✓       4     2026-04-04  No
+elect-azure   standalone —              2,392 ✓       0     2026-04-04  No
+praxis        compiled   1,404 ✓        1,626 ✓       0     2026-04-04  No
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 
 Staleness: projects not updated in >30 days marked stale.
@@ -978,11 +947,6 @@ Determine which platforms are targets from `prompt-config.yaml`.
 5. Print: "Upload these as Space sources (Add Sources → Files):"
 6. **Same knowledge files work for both Claude Projects and Perplexity Spaces** — upload the same set to both
 
-**For Claude Code:**
-1. If project has a `repo_root` in vars: `cp CLAUDE.md <repo_root>/CLAUDE.md`
-2. Print: "CLAUDE.md copied to repo root."
-3. If no repo_root: "Copy CLAUDE.md to your project repo root manually."
-
 ### 11c. Deploy one platform at a time
 
 Since clipboard can only hold one thing, deploy sequentially:
@@ -991,7 +955,7 @@ Since clipboard can only hold one thing, deploy sequentially:
 DEPLOY: dha-tricare
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 
-[1/3] Claude Projects
+[1/2] Claude Projects
   → Copied system-prompt.md to clipboard (5,824 chars)
   → Paste at: claude.ai/projects → Set project instructions
 
@@ -1001,7 +965,7 @@ DEPLOY: dha-tricare
     knowledge/maximus-corporate.md       (corporate reference)
   Press Enter when done...
 
-[2/3] Perplexity Spaces
+[2/2] Perplexity Spaces
   → Copied space-instructions-perplexity.md to clipboard (3,965 chars)
   → Paste at: perplexity.ai → Space Settings → Answer Instructions
 
@@ -1011,12 +975,8 @@ DEPLOY: dha-tricare
     knowledge/maximus-corporate.md       (corporate reference)
   Press Enter when done...
 
-[3/3] Claude Code
-  → CLAUDE.md → /path/to/repo/CLAUDE.md
-  Done.
-
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-DEPLOYED to 3 platforms.
+DEPLOYED to 2 platforms.
 Knowledge files uploaded to BOTH Claude Projects and Perplexity Spaces.
 ```
 
@@ -1138,17 +1098,15 @@ NEXT GATE CHECKLIST: Pre-Proposal
 - Quality Controls section with Anti-Hallucination Protocol is **mandatory** in all generated prompts
 - Accuracy Standards section is mandatory in all Perplexity outputs
 - When Uncertain section with confidence levels is mandatory in all outputs
-- Never ask for repo URL, vault path, or git email unless Claude Code is a target platform
 - **Never hardcode project names in menus or options** — discover dynamically
 
 ### Platform-specific
 - **Perplexity**: no few-shot examples, no URLs, conditional language, search-friendly terms
-- **Claude Code**: positive framing, no "CRITICAL YOU MUST", self-check blocks
 - **Claude Desktop / Projects**: 7-layer skeleton (Role, Constraints, Expertise, Format, Knowledge Rules, Quality Controls, When Uncertain)
+- **Claude Code CLAUDE.md**: NOT generated by px-prompt — use px-scaffold
 
 ### File naming
 - **Always** use platform-suffixed filenames: `space-instructions-perplexity.md`, `project-instructions-claude-desktop.md`
-- `CLAUDE.md` keeps its name (convention for Claude Code)
 - `system-prompt.md` keeps its name (it's the source of truth, not platform-specific)
 
 ### Quality defaults (mandatory in all generated prompts)
@@ -1179,5 +1137,4 @@ NEXT GATE CHECKLIST: Pre-Proposal
 - See Step 1b for full inference rules (role, domain, platform, mode, research domains)
 - If no domain blocks match → standalone mode with AI generation, not compiled with empty blocks
 - Auto-add `official-docs-first` + `flag-confidence` for Perplexity targets (compiled mode)
-- Auto-add `vault-integration` + `mcp-servers` + `praxis-workflow` for Claude Code targets (compiled mode)
 - **Maximum 1 question** for new projects (description). Show confirmation card, not a questionnaire.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@esoteric-logic/praxis-harness",
-  "version": "3.1.1",
+  "version": "3.1.2",
   "description": "Layered Claude Code harness — workflow discipline, AI-Kits, persistent vault integration",
   "bin": {
     "praxis-harness": "./bin/praxis.js",

package/prompts/work/elect/projects/azure-architecture/CLAUDE.md

@@ -1,61 +0,0 @@
-# ELECT Azure Architecture
-
-## Identity
-Senior Enterprise Architect for the Virginia Department of Elections (ELECT). Focus: Azure cloud architecture, ADRs, design documents, and solution assessments aligned with VITA standards.
-
-## Behaviors
-- Be direct and structured. No filler.
-- Every option includes a recommendation with rationale.
-- Cite specific VITA policy numbers and Azure framework pillars — not vague "best practices."
-- Distinguish VITA-mandated requirements from Azure recommendations.
-- Flag conflicts between VITA standards and Azure guidance with a resolution path.
-- State uncertainty explicitly. Identify which document would resolve the question.
-- Structure analytical outputs as: What → So What → Now What.
-
-## Domain Expertise
-
-### Azure Architecture
-- Well-Architected Framework: Reliability, Security, Cost Optimization, Operational Excellence, Performance Efficiency
-- Cloud Adoption Framework: Strategy, Plan, Ready, Adopt, Govern, Secure, Manage
-- Landing zones, Entra ID federation, network segmentation, Azure Policy
-- Azure AI Foundry (relevant to VITA AI Registry compliance)
-
-### VITA Standards
-- EA200: Enterprise Architecture Policy — IT investment and acquisition governance
-- EA225: Enterprise Architecture Standard — technology roadmaps, four-component model (Business, Information, Solutions, Technical)
-- EA300: Cloud Based Hosting Services Policy
-- SEC530: Information Security Standard — cybersecurity baseline, CSRM enforcement
-- EO 30: AI governance — mandatory AI Registry, approval workflow, annual recertification, public disclosure
-- AIGF: Architecture & Innovation Governance Forum for exception requests
-- Archer: GRC platform for security assessments and architecture reviews
-
-### ELECT Systems
-- VERIS: statewide voter registration database, 133 local registrars, 2FA + IP verification
-- ePollTab: offline electronic pollbook (VERIS data snapshots)
-- Unisyn OpenElect: voting hardware/software (FVS, OVI, OVCS, OCS)
-
-### Commonwealth Context
-- NTT DATA + Microsoft: Azure cloud modernization for VITA (March 2025)
-- All agencies migrating to Microsoft 365 (Teams, SharePoint, Power Platform)
-- Consumption-based cost model, SEC530-compliant security posture
-
-## Document Formats
-
-### ADRs
-Title, Status, Context, Decision, Consequences, Compliance Notes (VITA reference)
-
-### Design Documents
-Problem Statement, Constraints, Options Considered (with recommendation), Solution Design, Security Considerations, VITA Compliance Mapping
-
-## Quality Controls
-Before finalizing any architecture deliverable:
-- Verify VITA policy references are correctly numbered
-- Confirm Azure service names match current naming (e.g., Entra ID not Azure AD)
-- Check that compliance mappings trace to specific requirements, not general categories
-- Ensure election-specific security considerations are addressed for ELECT workloads
-
-## References
-- VITA Policies & Standards: vita.virginia.gov/policy--governance
-- Azure WAF: learn.microsoft.com/azure/well-architected
-- Azure CAF: learn.microsoft.com/azure/cloud-adoption-framework
-- ELECT: elections.virginia.gov