Files
dss/.dss/schema/workflows.schema.json
Digital Production Factory 93e1b452fb Phase 5: Add immutable file headers to all protected files
Added protection headers to 9 critical files:

JSON Files (x-immutable-notice field):
- .dss/schema/api.schema.json
- .dss/schema/tokens.schema.json
- .dss/schema/components.schema.json
- .dss/schema/workflows.schema.json
- .dss/schema/guardrails.schema.json
- dss-claude-plugin/.mcp.json

YAML File (comment header):
- .dss-boundaries.yaml

Markdown File (HTML comment):
- API_SPECIFICATION_IMMUTABLE.md

Python File (docstring header):
- dss-mvp1/dss/validators/schema.py

Each header includes:
- Protection notice
- Reason for immutability
- Last modified date
- Bypass instructions (DSS_IMMUTABLE_BYPASS=1)

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-12-09 19:34:32 -03:00

104 lines
3.1 KiB
JSON

{
"$schema": "http://json-schema.org/draft-07/schema#",
"$id": "https://dss.overbits.luz.uy/schemas/workflows.schema.json",
"title": "DSS Workflows Schema",
"description": "Common DSS workflow patterns for AI guidance",
"version": "2.0.0",
"x-immutable-notice": {
"protected": true,
"reason": "Workflow definitions - ensures consistent AI-guided operations",
"lastModified": "2025-12-09",
"bypassMethod": "Use 'DSS_IMMUTABLE_BYPASS=1 git commit' or commit message '[IMMUTABLE-UPDATE] reason'"
},
"type": "object",
"properties": {
"workflows": {
"type": "object",
"additionalProperties": {
"$ref": "#/definitions/workflow"
}
}
},
"definitions": {
"workflow": {
"type": "object",
"required": ["name", "description", "steps"],
"properties": {
"name": {
"type": "string",
"description": "Workflow identifier"
},
"description": {
"type": "string",
"description": "What this workflow accomplishes"
},
"category": {
"type": "string",
"enum": ["setup", "token-management", "component-analysis", "theme-generation", "integration"],
"description": "Workflow category"
},
"steps": {
"type": "array",
"description": "Ordered workflow steps",
"items": {
"type": "object",
"required": ["tool", "description"],
"properties": {
"step": {
"type": "integer",
"description": "Step number"
},
"tool": {
"type": "string",
"description": "DSS tool to use"
},
"description": {
"type": "string",
"description": "What this step does"
},
"parameters": {
"type": "object",
"description": "Typical parameters for this step"
},
"optional": {
"type": "boolean",
"default": false,
"description": "Whether this step can be skipped"
},
"conditions": {
"type": "array",
"description": "Conditions for executing this step",
"items": {
"type": "string"
}
}
}
}
},
"prerequisites": {
"type": "array",
"description": "Requirements before starting workflow",
"items": {
"type": "string"
}
},
"expectedOutcome": {
"type": "string",
"description": "What success looks like"
},
"commonErrors": {
"type": "array",
"description": "Common failure scenarios and solutions",
"items": {
"type": "object",
"properties": {
"error": {"type": "string"},
"solution": {"type": "string"}
}
}
}
}
}
}
}