Finalize Zip Deliverable

Finalize ZIP Deliverable

CRITICAL: This skill defines a MANDATORY workflow that MUST be executed before any task can be marked complete. Task completion is BLOCKED until ZIP verification passes.

Agents often assume that creating the project directory and files constitutes task completion. However, many tasks require a single downloadable artifact (ZIP file) for delivery. You are forbidden from declaring task completion until the ZIP artifact is created and verified.

ITERATION-AWARE PRIORITY: If the agent's iteration count approaches the task limit (e.g., iteration 25 of 30), ZIP creation MUST be elevated to highest priority. Do not continue adding features or refining code—execute the ZIP command immediately with whatever files exist.

Early Warning System

TRIGGER CONDITION: When iteration count reaches 25/30 (or 80% of any iteration limit), activate the following protocol:

1. Immediately halt any non-essential code generation or refinement.
2. Assess current state: List all files currently in the project directory.
3. Execute minimum viable ZIP: Package whatever exists, even if incomplete.
4. Document the fallback: Note in completion summary that ZIP was created as fallback due to iteration constraints.

RATIONALE: A partial ZIP deliverable is ALWAYS preferable to zero deliverable. Never exhaust iterations without creating the required artifact.

Minimum Viable ZIP Fallback

When triggered by the early warning system, execute this fallback procedure:

# Create ZIP with whatever files currently exist
zip -r project_fallback.zip ./project/ 2>/dev/null || zip -r project_fallback.zip ./*

# Verify creation succeeded
ls -lh project_fallback.zip

Acceptable fallback scenarios:

• ZIP contains partial codebase (better than nothing)
• ZIP contains only configuration files
• ZIP contains even a single source file

Unacceptable outcome: No ZIP file created due to iteration exhaustion.

Workflow Steps

1. Verify Project Completeness

0. Monitor Iteration Count (ONGOING)

Throughout task execution, track your iteration count relative to the task limit.

• Normal operation (iterations 1-24 of 30): Follow standard workflow, building codebase systematically.
• Warning zone (iterations 25-27 of 30): Begin preparing ZIP command; ensure project directory exists.
• Critical zone (iterations 28-30 of 30): ZIP creation is the ONLY remaining task. Execute minimum viable ZIP fallback if necessary.

Before archiving, confirm that all intended source code, configuration files, and assets exist within the project directory.

• Check that the root project directory exists.
• Verify critical files (e.g., package.json, README.md, source files) are present.
• Ensure no build artifacts or temporary files unintended for delivery are included (unless specified).

2. Execute Archive Command

Run the compression command explicitly as a dedicated action. Do not bundle this step with code generation.

zip -r <output_filename>.zip <project_directory>/

Example:

zip -r project.zip ./project

3. Verify Artifact Creation

Confirm the ZIP file was successfully created and is not empty.

• Check file existence: ls -lh <output_filename>.zip
• Check file size: Ensure the size is greater than 0 bytes.
• Optionally inspect contents: unzip -l <output_filename>.zip

4. Declare Completion