CtrlK
BlogDocsLog inGet started
Tessl Logo

pantheon-ai/implementation-plan-splitter

Merged into implementation-planner. Redirects to the unified skill that handles both creating new plans and restructuring existing monolithic planning docs into hierarchical directory structures.

63

Quality

63%

Does it follow best practices?

Impact

Pending

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

Overview
Quality
Evals
Security
Files

schemas-and-templates.mdreferences/

Schemas and Templates Reference

This file contains JSON schemas and YAML templates used by the automation scripts. Load ONLY when debugging validation or customizing automation.

JSON Schemas

Two JSON schemas validate file structure:

step-file.schema.json

Validates step/activity markdown files:

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "required": ["title", "description", "checklist", "acceptanceCriteria"],
  "properties": {
    "title": { "type": "string" },
    "description": { "type": "string", "minLength": 10 },
    "checklist": {
      "type": "array",
      "items": { "type": "string" },
      "minItems": 1
    },
    "acceptanceCriteria": {
      "type": "array", 
      "items": { "type": "string" },
      "minItems": 1
    },
    "status": {
      "type": "string",
      "enum": ["not-started", "in-progress", "complete", "blocked"]
    },
    "dependencies": {
      "type": "array",
      "items": { "type": "string" }
    }
  }
}

readme-file.schema.json

Validates README files:

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "required": ["title", "description"],
  "properties": {
    "title": { "type": "string" },
    "description": { "type": "string", "minLength": 20 },
    "contents": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "name": { "type": "string" },
          "path": { "type": "string" },
          "description": { "type": "string" }
        }
      }
    },
    "successCriteria": {
      "type": "array",
      "items": { "type": "string" }
    }
  }
}

YAML Templates

Templates are defined in templates/ directory and used by the automation scripts:

templates/phase-readme.yaml

Phase-level README with sections: Phase Header, Activities/Steps table, Success Criteria, Rollback Procedure.

title: "Phase {{number}}: {{name}}"
sections:
  - name: "Phase Header"
  - name: "{{type|title}}"  # "Activities" or "Steps"
  - name: "Success Criteria"
  - name: "Rollback Procedure"

Variables: number, name, description, type, type_singular, items[]

templates/intermediate-readme.yaml

Intermediate directory README for activities/ or steps/ folders.

title: "{{type|title}}"
sections:
  - name: "Description"
  - name: "Groups"

Variables: type

templates/group-readme.yaml

Group directory README (e.g., step-1-extract-and-refactor/README.md).

title: "{{type_singular|title}} {{number}}: {{name}}"
sections:
  - name: "Description"
  - name: "Files"
  - name: "Prerequisites"
  - name: "Status"

Variables: type_singular, number, name, description, sub_items_count, sub_items[]

templates/step-file.yaml

Step/activity leaf file template.

title: "{{type_singular|title}} {{number}}: {{name}}"
sections:
  - name: "Description"
  - name: "Checklist"
  - name: "Acceptance Criteria"
  - name: "Status"
  - name: "Notes"
  - name: "Dependencies"
defaults:
  status: "Not Started"
  dependencies: []

Variables: type_singular, number, name, description, checklist[], acceptance_criteria[], status, dependencies[]

Template Syntax

SyntaxDescriptionExample
{{variable}}Variable interpolation{{name}} → "Analysis"
{{kebab value}}Convert to kebab-case{{kebab name}} → "analysis-and-design"
{{value|title}}Title case filter{{type|title}} → "Activities"
{{#each array}}...{{/each}}Array iterationLoop through items
{{#if condition}}...{{/if}}ConditionalShow if truthy
{{#if cond}}...{{else}}...{{/if}}Conditional with elseShow alternate

references

example-transformation.md

schemas-and-templates.md

SKILL.md

tile.json