ccpe-system/.codex/skills/ccpe-forge/templates/ccpe-runtime.spec.md

4.7 KiB

artifact_type name runtime_id author version created updated status runtime_type target_platform based_on related_agents related_skills related_models
ccpe-runtime draft CCPE System

{Runtime Name}

1. Runtime Overview

1.1 Purpose

1.2 Runtime Type

Use one:

interactive-runtime
automation-runtime
hybrid-runtime

1.3 Operating Mode

Use one:

expert-mode
workshop-mode
automation-mode
hybrid-mode

1.4 Success Criteria

1.5 Non-Goals

2. Participants

2.1 Human Role

2.2 Agents

- agent_id:
  role:
  responsibility:
  invocation_condition:

2.3 Skills

- skill_id:
  purpose:
  invocation_condition:

2.4 Tools

- tool_name:
  purpose:
  permission:

3. Context Layer

3.1 Input Contract

3.2 Required Context

3.3 Optional Context

3.4 Shared Context

3.5 Source Policy

4. Authority Layer

4.1 Autonomous Actions

4.2 Actions Requiring Confirmation

4.3 Forbidden Actions

4.4 Human Decision Gates

Gate 1:
- Trigger:
- Human decision required:
- Possible outcomes:

Gate 2:
- Trigger:
- Human decision required:
- Possible outcomes:

4.5 Risk Levels

Low:
Medium:
High:
Critical:

5. Workflow Layer

5.1 Runtime Stages

Stage 1:
- Purpose:
- Actor:
- Input:
- Output:
- Human gate:

Stage 2:
- Purpose:
- Actor:
- Input:
- Output:
- Human gate:

5.2 Main Workflow

1.
2.
3.
4.
5.

5.3 Branch Logic

5.4 Loop Rules

5.5 Stop Conditions

5.6 Escalation Conditions

6. State Layer

6.1 Working State

6.2 Persistent State

6.3 Decision Log

6.4 Artifact Log

6.5 Resume Rules

7. Collaboration Layer

7.1 Handoff Protocol

7.2 Role Differentiation

7.3 Conflict Resolution

7.4 Synthesis Rules

8. Output Layer

8.1 Runtime Outputs

8.2 Intermediate Outputs

8.3 Output Format

# {Runtime Output Title}

## 1. Run Summary

## 2. Stage Outputs

## 3. Decisions

## 4. Final Result

## 5. Open Questions

## 6. Archive Notes

8.4 Archival Rules

9. Evaluation Layer

9.1 Validation Checklist

Objective fulfilled?
Stages completed?
Human gates respected?
Outputs validated?
State updated?
Errors handled?
Artifacts archived?

9.2 Quality Rubric

9.3 Failure Modes

9.4 Recovery Rules

10. Runtime Environment

10.1 Platform

10.2 File Access

10.3 Tool Access

10.4 Network Access

10.5 Logging

10.6 Versioning

11. Automation Boundary

11.1 Allowed Automation

-
-
-

11.2 Requires Confirmation

-
-
-

11.3 Forbidden Automation

-
-
-

12. Deployment Notes

12.1 Codex

12.2 Claude Code

12.3 OpenClaw

12.4 Manual Operation

13. Version Notes

v0.1:
- Initial draft.