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

5.0 KiB

artifact_type name agent_id author version created updated status target_platform based_on related_models related_skills related_runtimes
ccpe-agent draft CCPE System

{Agent Name}

1. Objective Layer

1.1 Primary Objective

1.2 Secondary Objectives

1.3 Non-Goals

1.4 Success Criteria

1.5 Failure Conditions

2. Role Layer

2.1 Role Attribute

2.2 Professional Background

2.3 Interaction Style

2.4 Reasoning Style

2.5 Core Values

2.6 Collaboration Position

3. Context Layer

3.1 Input Contract

3.2 Required Context

3.3 Optional Context

3.4 Source Policy

3.5 Memory / State Policy

3.6 Model Context

4. Capability Layer

4.1 Functional Scope

4.2 Professional Skills

4.3 Supported Tasks

4.4 Unsupported Tasks

4.5 Skill Calls

- skill_id:
  purpose:
  trigger:

5. Tool Layer

5.1 Available Tools

- tool_name:
  purpose:
  allowed_use:
  forbidden_use:

5.2 Tool Preconditions

5.3 Tool Failure Handling

6. Authority Layer

6.1 Autonomous Actions

6.2 Actions Requiring Confirmation

6.3 Forbidden Actions

6.4 Human Decision Gates

6.5 Escalation Rules

7. Workflow Layer

7.1 Trigger Conditions

7.2 Main Workflow

1.
2.
3.

7.3 Branch Logic

7.4 Follow-Up Mode

7.5 Stop Conditions

7.6 Handoff Points

8. Constraint Layer

8.1 Hard Constraints

8.2 Soft Constraints

8.3 Refusal Conditions

8.4 Conflict Resolution

9. State Layer

9.1 Working State

9.2 Persistent State

9.3 Decision Log

9.4 Resume Rules

10. Output Layer

10.1 Output Types

10.2 Default Output Format

# {Output Title}

## 1. Summary

## 2. Analysis

## 3. Recommendations

## 4. Open Questions

10.3 Output Quality Requirements

10.4 Downstream Consumers

11. Evaluation Layer

11.1 Validation Checklist

Objective fulfilled?
Input handled correctly?
Model applied faithfully?
Unsupported assumptions marked?
Output usable?
Human decision gates respected?

11.2 Quality Rubric

11.3 Failure Modes

11.4 Human Acceptance Criteria

12. Collaboration Layer

12.1 Collaborators

12.2 Role Differentiation

12.3 Handoff Protocol

12.4 Conflict Handling

13. Runtime Notes

13.1 Runtime Usage

13.2 Platform Notes

14. Version Notes

v0.1:
- Initial draft.