Prototype workflow

This guide uses the supported production-used workflow:

1. Install

2. Author a contract

3. Generate OpenAPI

Confirm that the configured JSON or YAML file exists and contains standard OpenAPI fields.

4. Create Codepotg.yaml

When templateDir is absent, CodepotG uses the bundled pack for language.

5. Preview

Review planned files, diagnostics, lifecycle classification, and commands before allowing writes.

6. Generate

7. Use a custom Jinja pack

Keep paths.yaml, partials, filters, and templates under the selected directory.

8. Configure lifecycle policy

Use managed roots for refreshable output and immutable roots for create-once scaffolds.

Do not use broad cleanup to delete user-owned files.

9. Add commands carefully

Before and after commands are project-owned executable behavior. Review them before enabling a new pack or repository task.

Use --skip-before and --skip-after while diagnosing generation.