@theglitchking/persistent-planning 3.0.1 → 3.4.0

package/.claude-plugin/marketplace.json

@@ -6,13 +6,13 @@
   },
   "metadata": {
     "description": "Official marketplace for persistent-planning - Persistent markdown-based planning for Claude Code. Context engineering pattern with task directories, progress tracking, and working memory that persists across sessions.",
-    "version": "3.0.1"
+    "version": "3.4.0"
   },
   "plugins": [
     {
       "name": "persistent-planning",
       "description": "Persistent markdown-based planning for Claude Code. Uses on-disk markdown files as working memory for planning, progress tracking, and knowledge storage. Plans persist across sessions and support multiple concurrent tasks.",
-      "version": "3.0.1",
+      "version": "3.4.0",
       "author": {
         "name": "TheGlitchKing"
       },

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "persistent-planning",
-  "version": "3.0.1",
+  "version": "3.4.0",
   "description": "Persistent markdown-based planning with task directories, progress tracking, and context engineering for multi-step Claude Code workflows",
   "author": {
     "name": "TheGlitchKing"

package/.documentation/INDEX.md

@@ -0,0 +1,224 @@
+---
+title: Documentation Index
+tier: reference
+domains: [root]
+status: active
+last_updated: '2026-09-04'
+version: '1.0.0'
+purpose: Navigation hub for all documentation
+---
+
+# Documentation Index
+
+> Complete listing of all documentation organized by domain.
+
+## Overview
+
+| Domain | Documents | Description |
+|--------|-----------|-------------|
+| [Agents](#agents) | 0 | Expert agent documentation, specialty matrix |
+| [API](#api) | 0 | API endpoints, routes, specifications, contracts |
+| [Architecture](#architecture) | 4 | System design, AI coach, project registry, patterns |
+| [Backups](#backups) | 0 | Backup/restore guides, disaster recovery |
+| [Database](#database) | 0 | Schema, migrations, RLS, queries, procedures |
+| [DevOps](#devops) | 0 | Deployment, CI/CD, Docker, environments, infrastructure |
+| [Features](#features) | 0 | Feature implementation guides, admin docs |
+| [Plans](#plans) | 0 | Planning documents, roadmaps, proposals |
+| [Procedures](#procedures) | 2 | Step-by-step operational procedures (SOP) |
+| [Quickstart](#quickstart) | 1 | Setup guides, dev workflow, onboarding |
+| [Security](#security) | 0 | Security, auth, Vault, Keycloak, RLS |
+| [Standards](#standards) | 2 | Coding standards (backend, frontend, database, devops, security) |
+| [Testing](#testing) | 1 | Test strategies, fixtures, patterns, integration/e2e |
+| [Troubleshooting](#troubleshooting) | 2 | Debug guides, common issues, solutions |
+| [Workflows](#workflows) | 0 | Process documentation, multi-step operations |
+| [Reference](#reference) | 3 | Schema, frontmatter, and CLI reference material for the planning artifacts |
+
+---
+
+## Agents
+
+> Expert agent documentation, specialty matrix
+
+**Path:** `agents/`
+
+*No documents yet.*
+
+---
+
+## API
+
+> API endpoints, routes, specifications, contracts
+
+**Path:** `api/`
+
+*No documents yet.*
+
+---
+
+## Architecture
+
+> System design, AI coach, project registry, patterns
+
+**Path:** `architecture/`
+
+| Document | Tier | Status | Updated |
+|----------|------|--------|----------|
+| [Manus Context Engineering Principles](architecture/context-engineering-principles.md) | reference | active | 2026-08-31 |
+| [Lg-Mode Layered Planning Guide](architecture/lg-mode.md) | guide | active | 2026-05-07 |
+| [lg plan artifact lifecycle — who writes what](architecture/lg-plan-artifact-lifecycle.md) | reference | active | 2026-09-04 |
+| [Skill linking and reclaim](architecture/skill-linking-and-reclaim.md) | reference | active | 2026-09-04 |
+
+---
+
+## Backups
+
+> Backup/restore guides, disaster recovery
+
+**Path:** `backups/`
+
+*No documents yet.*
+
+---
+
+## Database
+
+> Schema, migrations, RLS, queries, procedures
+
+**Path:** `database/`
+
+*No documents yet.*
+
+---
+
+## DevOps
+
+> Deployment, CI/CD, Docker, environments, infrastructure
+
+**Path:** `devops/`
+
+*No documents yet.*
+
+---
+
+## Features
+
+> Feature implementation guides, admin docs
+
+**Path:** `features/`
+
+*No documents yet.*
+
+---
+
+## Plans
+
+> Planning documents, roadmaps, proposals
+
+**Path:** `plans/`
+
+*No documents yet.*
+
+---
+
+## Procedures
+
+> Step-by-step operational procedures (SOP)
+
+**Path:** `procedures/`
+
+| Document | Tier | Status | Updated |
+|----------|------|--------|----------|
+| [Plan Completion and Archive](procedures/plan-completion-and-archive.md) | guide | active | 2026-08-31 |
+| [Plugin update delivery — what actually runs, and when](procedures/plugin-update-delivery.md) | guide | active | 2026-09-04 |
+
+---
+
+## Quickstart
+
+> Setup guides, dev workflow, onboarding
+
+**Path:** `quickstart/`
+
+| Document | Tier | Status | Updated |
+|----------|------|--------|----------|
+| [Examples: Persistent Planning in Action](quickstart/examples.md) | plan | active | 2026-08-31 |
+
+---
+
+## Security
+
+> Security, auth, Vault, Keycloak, RLS
+
+**Path:** `security/`
+
+*No documents yet.*
+
+---
+
+## Standards
+
+> Coding standards (backend, frontend, database, devops, security)
+
+**Path:** `standards/`
+
+| Document | Tier | Status | Updated |
+|----------|------|--------|----------|
+| [Atom Granularity (anti-pattern guide)](standards/atom-granularity.md) | standard | active | 2026-05-07 |
+| [Mandatory Closing Phases](standards/mandatory-closing-phases.md) | standard | active | 2026-08-31 |
+
+---
+
+## Testing
+
+> Test strategies, fixtures, patterns, integration/e2e
+
+**Path:** `testing/`
+
+| Document | Tier | Status | Updated |
+|----------|------|--------|----------|
+| [Test Suite](testing/test-suite.md) | guide | active | 2026-08-31 |
+
+---
+
+## Troubleshooting
+
+> Debug guides, common issues, solutions
+
+**Path:** `troubleshooting/`
+
+| Document | Tier | Status | Updated |
+|----------|------|--------|----------|
+| [A plan won't read COMPLETE](troubleshooting/plan-never-reads-complete.md) | guide | active | 2026-09-04 |
+| [Stale skill directory — commands run frozen code](troubleshooting/stale-skill-dir-drift.md) | guide | active | 2026-09-04 |
+
+---
+
+## Workflows
+
+> Process documentation, multi-step operations
+
+**Path:** `workflows/`
+
+*No documents yet.*
+
+---
+
+## Reference
+
+> Schema, frontmatter, and CLI reference material for the planning artifacts
+
+**Path:** `reference/`
+
+| Document | Tier | Status | Updated |
+|----------|------|--------|----------|
+| [`mandatory:` task frontmatter](reference/mandatory-frontmatter.md) | reference | active | 2026-09-04 |
+| [Skill version marker (`.version`)](reference/skill-version-marker.md) | reference | active | 2026-09-04 |
+| [workspace.json schema](reference/workspace-json.md) | standard | active | 2026-05-07 |
+
+---
+
+## Maintenance
+
+- **Last generated:** 2026-09-04
+- **Run maintenance:** `npx hit-em-with-the-docs maintain`
+- **Regenerate index:** `npx hit-em-with-the-docs index`

package/.documentation/README.md

@@ -0,0 +1,90 @@
+---
+title: Documentation
+tier: reference
+domains:
+  - database
+  - procedures
+audience:
+  - developers
+  - devops
+  - admin
+tags:
+  - api
+  - database
+  - testing
+  - security
+status: draft
+last_updated: '2026-08-31'
+version: 1.0.0
+purpose: This documentation system uses a hierarchical, domain-based structure
+  for optimal organization and discoverability.
+estimated_read_time: 2 minutes
+word_count: 250
+last_validated: '2026-08-31'
+backlinks: []
+---
+
+# Documentation
+
+This documentation system uses a hierarchical, domain-based structure for optimal organization and discoverability.
+
+## Quick Navigation
+
+- **[INDEX.md](INDEX.md)** - Complete document listing with metadata
+- **[REGISTRY.md](REGISTRY.md)** - Quick reference tables
+
+## Domains
+
+| Domain | Description |
+|--------|-------------|
+| [agents](agents/) | Expert agent documentation, specialty matrix |
+| [api](api/) | API endpoints, routes, specifications, contracts |
+| [architecture](architecture/) | System design, AI coach, project registry, patterns |
+| [backups](backups/) | Backup/restore guides, disaster recovery |
+| [database](database/) | Schema, migrations, RLS, queries, procedures |
+| [devops](devops/) | Deployment, CI/CD, Docker, environments, infrastructure |
+| [features](features/) | Feature implementation guides, admin docs |
+| [plans](plans/) | Planning documents, roadmaps, proposals |
+| [procedures](procedures/) | Step-by-step operational procedures (SOP) |
+| [quickstart](quickstart/) | Setup guides, dev workflow, onboarding |
+| [security](security/) | Security, auth, Vault, Keycloak, RLS |
+| [standards](standards/) | Coding standards (backend, frontend, database, devops, security) |
+| [testing](testing/) | Test strategies, fixtures, patterns, integration/e2e |
+| [troubleshooting](troubleshooting/) | Debug guides, common issues, solutions |
+| [workflows](workflows/) | Process documentation, multi-step operations |
+
+## Adding New Documentation
+
+1. Identify the correct domain for your document
+2. Create the file in the domain directory
+3. Add YAML frontmatter with required metadata
+4. Run `npx hit-em-with-the-docs integrate <file>` to register
+
+## Metadata Schema
+
+Every document should include:
+
+```yaml
+---
+title: "Document Title"
+tier: guide|standard|example|reference|admin
+domains: [primary-domain]
+status: draft|active|deprecated|archived
+last_updated: 'YYYY-MM-DD'
+version: '1.0.0'
+---
+```
+
+## Maintenance
+
+Run weekly maintenance with:
+
+```bash
+npx hit-em-with-the-docs maintain
+```
+
+This will:
+- Sync metadata across all documents
+- Check for broken links
+- Audit compliance
+- Generate health reports

package/.documentation/REGISTRY.md

@@ -0,0 +1,80 @@
+---
+title: Documentation Registry
+tier: reference
+domains: [root]
+status: active
+last_updated: '2026-09-04'
+version: '1.0.0'
+purpose: Quick reference for all documentation domains
+---
+
+# Documentation Registry
+
+> Quick reference tables for fast navigation.
+
+## Domain Quick Reference
+
+| Domain | Category | Priority | Keywords |
+|--------|----------|----------|----------|
+| [Agents](agents/) | advanced | 5/10 | agent, agents, ai |
+| [API](api/) | core | 8/10 | api, endpoint, endpoints |
+| [Architecture](architecture/) | development | 7/10 | architecture, design, system |
+| [Backups](backups/) | advanced | 4/10 | backup, backups, restore |
+| [Database](database/) | core | 8/10 | database, db, postgres |
+| [DevOps](devops/) | core | 8/10 | devops, deployment, deploy |
+| [Features](features/) | features | 6/10 | feature, features, implementation |
+| [Plans](plans/) | advanced | 3/10 | plan, plans, planning |
+| [Procedures](procedures/) | features | 6/10 | procedure, procedures, sop |
+| [Quickstart](quickstart/) | features | 9/10 | quickstart, quick-start, getting-started |
+| [Security](security/) | core | 9/10 | security, auth, authentication |
+| [Standards](standards/) | development | 10/10 | standard, standards, convention |
+| [Testing](testing/) | development | 7/10 | test, testing, tests |
+| [Troubleshooting](troubleshooting/) | advanced | 6/10 | troubleshooting, troubleshoot, debug |
+| [Workflows](workflows/) | features | 5/10 | workflow, workflows, process |
+| [Reference](reference/) | development | 7/10 | schema, frontmatter, workspace.json |
+
+## By Category
+
+### Core
+
+- **[API](api/)** - API endpoints, routes, specifications, contracts
+- **[Database](database/)** - Schema, migrations, RLS, queries, procedures
+- **[DevOps](devops/)** - Deployment, CI/CD, Docker, environments, infrastructure
+- **[Security](security/)** - Security, auth, Vault, Keycloak, RLS
+
+### Development
+
+- **[Architecture](architecture/)** - System design, AI coach, project registry, patterns
+- **[Standards](standards/)** - Coding standards (backend, frontend, database, devops, security)
+- **[Testing](testing/)** - Test strategies, fixtures, patterns, integration/e2e
+- **[Reference](reference/)** - Schema, frontmatter, and CLI reference material for the planning artifacts
+
+### Features
+
+- **[Features](features/)** - Feature implementation guides, admin docs
+- **[Procedures](procedures/)** - Step-by-step operational procedures (SOP)
+- **[Quickstart](quickstart/)** - Setup guides, dev workflow, onboarding
+- **[Workflows](workflows/)** - Process documentation, multi-step operations
+
+### Advanced
+
+- **[Agents](agents/)** - Expert agent documentation, specialty matrix
+- **[Backups](backups/)** - Backup/restore guides, disaster recovery
+- **[Plans](plans/)** - Planning documents, roadmaps, proposals
+- **[Troubleshooting](troubleshooting/)** - Debug guides, common issues, solutions
+
+## Common Tasks
+
+| Task | Start Here |
+|------|------------|
+| New developer setup | [quickstart/](quickstart/) |
+| Coding standards | [standards/](standards/) |
+| API development | [api/](api/) |
+| Security implementation | [security/](security/) |
+| Database changes | [database/](database/) |
+| Deployment | [devops/](devops/) |
+| Troubleshooting | [troubleshooting/](troubleshooting/) |
+
+---
+
+*Last updated: 2026-09-04*

package/.documentation/agents/INDEX.md

@@ -0,0 +1,43 @@
+---
+title: Agents Documentation Index
+tier: reference
+domains: [agents]
+status: active
+last_updated: '2026-09-04'
+version: '1.0.0'
+purpose: Complete listing of agents documentation
+---
+
+# Agents Documentation
+
+> Expert agent documentation, specialty matrix
+
+## Overview
+
+- **Total Documents:** 0
+- **Domain:** `agents/`
+- **Category:** advanced
+- **Load Priority:** 5/10
+
+## Documents
+
+*No documents in this domain yet.*
+
+To add a document:
+
+1. Create a markdown file in this directory
+2. Add YAML frontmatter with required metadata
+3. Run `npx hit-em-with-the-docs integrate <file>`
+## Keywords
+
+This domain covers: agent, agents, ai, assistant, expert, specialist, llm, langchain, rag, retrieval
+
+## Related Domains
+
+- [Backups](../backups/) - Backup/restore guides, disaster recovery
+- [Plans](../plans/) - Planning documents, roadmaps, proposals
+- [Troubleshooting](../troubleshooting/) - Debug guides, common issues, solutions
+
+---
+
+*Last updated: 2026-09-04*

package/.documentation/agents/REGISTRY.md

@@ -0,0 +1,38 @@
+---
+title: Agents Registry
+tier: reference
+domains: [agents]
+status: active
+last_updated: '2026-09-04'
+version: '1.0.0'
+purpose: Quick reference for agents documentation
+---
+
+# Agents Registry
+
+> Quick reference for expert agent documentation, specialty matrix.
+
+## At a Glance
+
+| Metric | Value |
+|--------|-------|
+| Documents | 0 |
+| Category | advanced |
+| Load Priority | 5/10 |
+
+## Documents
+
+*No documents in this domain yet.*
+
+## Keywords
+
+`agent` `agents` `ai` `assistant` `expert` `specialist` `llm` `langchain` `rag` `retrieval` `embedding` `vector` `prompt` `orchestration` `chain` `tool`
+
+## See Also
+
+- [Full Index](INDEX.md) - Complete document listing
+- [Root Index](../INDEX.md) - All domains
+
+---
+
+*Last updated: 2026-09-04*

package/.documentation/api/INDEX.md

@@ -0,0 +1,43 @@
+---
+title: API Documentation Index
+tier: reference
+domains: [api]
+status: active
+last_updated: '2026-09-04'
+version: '1.0.0'
+purpose: Complete listing of api documentation
+---
+
+# API Documentation
+
+> API endpoints, routes, specifications, contracts
+
+## Overview
+
+- **Total Documents:** 0
+- **Domain:** `api/`
+- **Category:** core
+- **Load Priority:** 8/10
+
+## Documents
+
+*No documents in this domain yet.*
+
+To add a document:
+
+1. Create a markdown file in this directory
+2. Add YAML frontmatter with required metadata
+3. Run `npx hit-em-with-the-docs integrate <file>`
+## Keywords
+
+This domain covers: api, endpoint, endpoints, route, routes, rest, restful, graphql, grpc, openapi
+
+## Related Domains
+
+- [Database](../database/) - Schema, migrations, RLS, queries, procedures
+- [DevOps](../devops/) - Deployment, CI/CD, Docker, environments, infrastructure
+- [Security](../security/) - Security, auth, Vault, Keycloak, RLS
+
+---
+
+*Last updated: 2026-09-04*

package/.documentation/api/REGISTRY.md

@@ -0,0 +1,38 @@
+---
+title: API Registry
+tier: reference
+domains: [api]
+status: active
+last_updated: '2026-09-04'
+version: '1.0.0'
+purpose: Quick reference for api documentation
+---
+
+# API Registry
+
+> Quick reference for api endpoints, routes, specifications, contracts.
+
+## At a Glance
+
+| Metric | Value |
+|--------|-------|
+| Documents | 0 |
+| Category | core |
+| Load Priority | 8/10 |
+
+## Documents
+
+*No documents in this domain yet.*
+
+## Keywords
+
+`api` `endpoint` `endpoints` `route` `routes` `rest` `restful` `graphql` `grpc` `openapi` `swagger` `specification` `contract` `request` `response` `http` `fastapi` `express` `flask` `django`
+
+## See Also
+
+- [Full Index](INDEX.md) - Complete document listing
+- [Root Index](../INDEX.md) - All domains
+
+---
+
+*Last updated: 2026-09-04*

package/.documentation/architecture/INDEX.md

@@ -0,0 +1,50 @@
+---
+title: Architecture Documentation Index
+tier: reference
+domains: [architecture]
+status: active
+last_updated: '2026-09-04'
+version: '1.0.0'
+purpose: Complete listing of architecture documentation
+---
+
+# Architecture Documentation
+
+> System design, AI coach, project registry, patterns
+
+## Overview
+
+- **Total Documents:** 4
+- **Domain:** `architecture/`
+- **Category:** development
+- **Load Priority:** 7/10
+
+## Documents
+
+### Guides
+
+| Document | Status | Updated | Words |
+|----------|--------|---------|-------|
+| [Lg-Mode Layered Planning Guide](lg-mode.md) | active | 2026-05-07 | 720 |
+
+### References
+
+| Document | Status | Updated | Words |
+|----------|--------|---------|-------|
+| [Manus Context Engineering Principles](context-engineering-principles.md) | active | 2026-08-31 | 428 |
+| [lg plan artifact lifecycle — who writes what](lg-plan-artifact-lifecycle.md) | active | 2026-09-04 | 438 |
+| [Skill linking and reclaim](skill-linking-and-reclaim.md) | active | 2026-09-04 | 348 |
+
+## Keywords
+
+This domain covers: architecture, design, system, system-design, pattern, patterns, microservices, monolith, serverless, event-driven
+
+## Related Domains
+
+- [Standards](../standards/) - Coding standards (backend, frontend, database, devops, security)
+- [Testing](../testing/) - Test strategies, fixtures, patterns, integration/e2e
+- [Reference](../reference/) - Schema, frontmatter, and CLI reference material for the planning artifacts
+
+---
+
+*Last updated: 2026-09-04*

package/.documentation/architecture/REGISTRY.md

@@ -0,0 +1,57 @@
+---
+title: Architecture Registry
+tier: reference
+domains: [architecture]
+status: active
+last_updated: '2026-09-04'
+version: '1.0.0'
+purpose: Quick reference for architecture documentation
+---
+
+# Architecture Registry
+
+> Quick reference for system design, ai coach, project registry, patterns.
+
+## At a Glance
+
+| Metric | Value |
+|--------|-------|
+| Documents | 4 |
+| Category | development |
+| Load Priority | 7/10 |
+
+## Active Documents
+
+- [Manus Context Engineering Principles](context-engineering-principles.md)
+- [Lg-Mode Layered Planning Guide](lg-mode.md)
+- [lg plan artifact lifecycle — who writes what](lg-plan-artifact-lifecycle.md)
+- [Skill linking and reclaim](skill-linking-and-reclaim.md)
+
+## Recently Updated
+
+- [lg plan artifact lifecycle — who writes what](lg-plan-artifact-lifecycle.md) - 2026-09-04
+- [Skill linking and reclaim](skill-linking-and-reclaim.md) - 2026-09-04
+- [Manus Context Engineering Principles](context-engineering-principles.md) - 2026-08-31
+- [Lg-Mode Layered Planning Guide](lg-mode.md) - 2026-05-07
+
+## By Status
+
+| Status | Count |
+|--------|-------|
+| active | 4 |
+| draft | 0 |
+| deprecated | 0 |
+| archived | 0 |
+
+## Keywords
+
+`architecture` `design` `system` `system-design` `pattern` `patterns` `microservices` `monolith` `serverless` `event-driven` `cqrs` `ddd` `domain-driven` `clean-architecture` `hexagonal` `decision` `adr` `registry` `diagram`
+
+## See Also
+
+- [Full Index](INDEX.md) - Complete document listing
+- [Root Index](../INDEX.md) - All domains
+
+---
+
+*Last updated: 2026-09-04*