zzzops/templates/project-goals/INIT_PLAN.json

{
  "schema_version": 1,
  "base_digest": "sha256:replace-from-init-inspect",
  "confirmed": false,
  "backend": "github_issues",
  "repository": {
    "identity": "owner/repository",
    "remote": "https://github.com/owner/repository.git"
  },
  "charter": {
    "outcome": "replace with the confirmed observable project outcome",
    "beneficiaries": ["replace with confirmed beneficiaries"],
    "why_it_matters": "replace with confirmed value rationale",
    "time_horizon": "replace with confirmed horizon",
    "kpis": [
      {
        "name": "replace",
        "why": "replace",
        "baseline": "replace",
        "target": "replace",
        "evidence": "replace",
        "cadence": "replace"
      }
    ],
    "acceptance_criteria": ["replace with a confirmed observable condition"],
    "precedence": "replace with confirmed priority when metrics conflict",
    "constraints": ["replace with a confirmed constraint"],
    "non_goals": ["replace with a confirmed non-goal"],
    "unacceptable_tradeoffs": ["replace with a confirmed unacceptable tradeoff"]
  },
  "evidence": [
    {"id": "E-001", "kind": "observed", "source": "README.md", "finding": "replace"},
    {"id": "E-002", "kind": "proposed", "source": "agent synthesis", "finding": "replace"}
  ],
  "confirmations": [
    {"evidence_id": "E-002", "confirmed_by": "user", "date": "YYYY-MM-DD"}
  ],
  "github": {
    "usable": false
  },
  "policy": {
    "schema_version": 1,
    "sections": [
      {
        "id": "backend", "default_id": "zzzops.policy.backend", "title": "Canonical goal backend", "required": true, "applicable": true,
        "decision": "github_issues", "rationale": "replace with capability evidence and repository identity",
        "source_ids": ["E-002"], "confidence": "medium", "default_origin": "ZzzOps GitHub-only authority", "default_disposition": "accepted",
        "settings": {
          "authority": "github_issues", "repository_identity": "owner/repository", "fallback": "forbidden",
          "capability_evidence": "replace with the GitHub capability probe result",
          "tradeoffs": {"github_issues": "shared native issue queue requiring GitHub access"}
        },
        "exceptions": [], "unresolved": [], "review": {"approved": false}
      },
      {
        "id": "git_review_release", "default_id": "zzzops.policy.git_review_release", "title": "Git, review, and release", "required": true, "applicable": true,
        "decision": "Follow repository rules; otherwise keep one branch and PR per source-changing goal, continue descendants from each exact verified predecessor checkpoint, collect human PR approval at true queue exhaustion, and integrate in dependency order. Policy review remains required before execution; required checks, human merge approval, and release authority are never bypassed.", "rationale": "maximizes safe unattended progress while preserving independently reviewable PR gates and an explicit stricter per-goal alternative",
        "source_ids": ["E-002"], "confidence": "medium", "default_origin": "ZzzOps exhaustion-time review fallback", "default_disposition": "accepted",
        "settings": {
          "execution_branch": "per_goal", "branch_base": "nearest_authorized_trunk", "dependency_base": "dependency_branch",
          "review_pending_dependency": "stack_from_reviewed_checkpoint", "read_only_dependency_investigation": "allowed_before_completion",
          "multiple_dependency_base": "reviewed_base_containing_all", "parent_pseudo_trunk": true, "child_target": "nearest_parent_branch",
          "pull_request_unit": "per_goal", "shared_pull_request": "explicit_reviewed_override",
          "commit_unit": "verified_subgoal", "commit_style": "conventional", "review_gate": "human_at_exhaustion",
          "review_state_reads_per_checkpoint": 1,
          "pr_approval": "required_when_repository_requires_pr", "conversational_approval": "never_for_goal_progress", "merge_after_approval": "when_authorized"
        },
        "exceptions": [], "unresolved": [], "review": {"approved": false}
      },
      {
        "id": "execution_continuation", "default_id": "zzzops.policy.execution_continuation", "title": "Execution and work continuation", "required": true, "applicable": true,
        "decision": "Continue across actionable goals under reviewed dependency and resource policy, and incorporate newly captured goals at the next safe checkpoint.", "rationale": "reduces babysitting without forcing sequential work when bounded parallelism is safe",
        "source_ids": ["E-002"], "confidence": "medium", "default_origin": "ZzzOps first-release fallback", "default_disposition": "accepted",
        "settings": {
          "continue_while_actionable": true, "triage_new_first": true, "max_easy_wins": 2,
          "execute_intent": "same_task_until_superseded", "new_goal_checkpoint": "next_safe_checkpoint",
          "after_additive_capture": "resume_once_and_reprioritize", "exhausted_handoff_retains_intent": true,
          "human_unblock_watch": {
            "enabled": false, "trigger": "disabled_for_unattended_execution", "max_blockers": 1,
            "notify_once": true, "poll_seconds": 30, "max_seconds": 180
          },
          "stop_reasons_clear_intent": ["user_stop", "pause", "replacement_request", "capture_only", "required_authority", "blocking_boundary"],
          "cross_task": "require_explicit_harness_signal"
        },
        "exceptions": [], "unresolved": [], "review": {"approved": false}
      },
      {
        "id": "verification_testing", "default_id": "zzzops.policy.verification_testing", "title": "Verification and testing", "required": true, "applicable": true,
        "decision": "Require artifact-appropriate observable evidence in small chunks; documentation and test cases need no recursive tests, while product behavior and reusable test infrastructure require direct verification.", "rationale": "prevents unobservable product changes and false confidence without manufacturing documentation or test meta-tests",
        "source_ids": ["E-002"], "confidence": "high", "default_origin": "ZzzOps observable-work fallback", "default_disposition": "accepted",
        "settings": {
          "mode": "chunk_probe", "widen": "as_relevant", "test_bug": "capture_and_ask",
          "ci_deduplication": {
            "local_probe": "smallest_unique_falsifiable_signal",
            "skip_broad_local_when": "same_command_required_ci",
            "required_ci": "inspect_exact_pr_head",
            "failure": "inspect_logs_and_reprobe",
            "unavailable": "durable_blocker"
          },
          "artifact_verification": {
            "product_runtime": "risk_proportionate_behavioral_probe",
            "documentation": "inspect_artifact_no_feature_test",
            "test_cases": "run_changed_tests_no_recursive_meta_test",
            "test_harness": "focused_behavioral_regression"
          }
        },
        "exceptions": [], "unresolved": [], "review": {"approved": false}
      },
      {
        "id": "code_quality", "default_id": "zzzops.policy.code_quality", "title": "Code-quality and refactoring boundaries", "required": true, "applicable": true,
        "decision": "Preserve behavior unless a goal explicitly authorizes a behavior change.", "rationale": "separates cleanup from product decisions",
        "source_ids": ["E-002"], "confidence": "medium", "default_origin": "ZzzOps conservative fallback", "default_disposition": "accepted",
        "settings": {
          "non_behavioral_only_without_feature_goal": true, "completion_self_review": "required_before_review_or_done",
          "review_scope": "goal_diff_tests_and_relevant_surroundings", "dead_code": "remove_only_if_evidenced_and_in_scope",
          "dynamic_generated_vendor": "retain_without_proof", "record_clean_review": true, "reverify_after_changes": true
        },
        "exceptions": [], "unresolved": [], "review": {"approved": false}
      },
      {
        "id": "dependencies_tooling", "default_id": "zzzops.policy.dependencies_tooling", "title": "Dependencies, tooling, and generated artifacts", "required": true, "applicable": true,
        "decision": "Use project-native tooling; do not hand-edit generated or dependency-owned files.", "rationale": "replace with repository-specific commands and ownership evidence",
        "source_ids": ["E-002"], "confidence": "medium", "default_origin": "ZzzOps conservative fallback", "default_disposition": "accepted",
        "settings": {"tooling": "project_native", "generated_files": "source_or_generator_only", "dependency_changes": "explicit_scope"},
        "exceptions": [], "unresolved": [], "review": {"approved": false}
      },
      {
        "id": "security_privacy_compliance", "default_id": "zzzops.policy.security_privacy_compliance", "title": "Security, privacy, secrets, and compliance", "required": true, "applicable": true,
        "decision": "Repository policy may tighten but never weaken ZzzOps safety and authority boundaries.", "rationale": "record applicable project constraints without making safety optional",
        "source_ids": ["E-002"], "confidence": "medium", "default_origin": "immutable ZzzOps boundary", "default_disposition": "accepted",
        "settings": {"secrets": "never_expose", "production_mutation": "explicit_authority", "project_constraints": []},
        "exceptions": [], "unresolved": [], "review": {"approved": false}
      },
      {
        "id": "documentation_style", "default_id": "zzzops.policy.documentation_style", "title": "Documentation and style", "required": true, "applicable": true,
        "decision": "Follow evidenced repository documentation, style, and user-communication conventions.", "rationale": "keep communication project-appropriate while providing a concise ZzzOps fallback",
        "source_ids": ["E-002"], "confidence": "medium", "default_origin": "ZzzOps fallback overridden by repository or user evidence", "default_disposition": "accepted",
        "settings": {"documentation": "repository_conventions", "style": "repository_conventions", "communication": {"style": "outcome_first", "technical_detail": "decision_risk_failure_or_request", "user_action": "one_clear_action_with_reason_and_next_step"}},
        "exceptions": [], "unresolved": [], "review": {"approved": false}
      },
      {
        "id": "deployment_resources", "default_id": "zzzops.policy.deployment_resources", "title": "Deployment, environment, and resources", "required": true, "applicable": true,
        "decision": "Do not deploy without authority; choose bounded parallelism from the deterministic tracked-file repository size.", "rationale": "limits external impact and avoids multiplying large writable checkouts",
        "source_ids": ["E-002"], "confidence": "medium", "default_origin": "ZzzOps conservative fallback", "default_disposition": "accepted",
        "settings": {"deployment": "explicit_authority", "resource_mode": "size_aware", "delegate_wait_after_seconds": 60},
        "exceptions": [], "unresolved": [], "review": {"approved": false}
      },
      {
        "id": "engineering_rigor", "default_id": "zzzops.policy.engineering_rigor", "title": "Engineering rigor", "required": true, "applicable": true,
        "decision": "structured", "rationale": "Balance production-oriented specification and verification with escalation-ready harness investment; higher-risk work can automatically require agentic evidence.",
        "source_ids": ["E-002"], "confidence": "medium", "default_origin": "ZzzOps production-oriented fallback", "default_disposition": "accepted",
        "settings": {
          "escalation": {"enabled": true, "allow_automatic_escalation": true, "allow_automatic_deescalation": false},
          "minimums": {
            "authentication": "agentic", "authorization": "agentic", "payments": "agentic", "secrets": "agentic",
            "destructive_data_migrations": "agentic", "security_sensitive": "agentic", "throwaway_prototypes": "vibe"
          },
          "overrides": {
            "per_goal": true, "raising": "allowed", "lowering": "explicit_user_authority", "may_undercut_risk_minimum": false
          },
          "requirements_interview": {
            "source": "effective_engineering_rigor",
            "level_mapping": {"vibe": "light", "structured": "standard", "agentic": "thorough"}
          }
        },
        "exceptions": [], "unresolved": [], "review": {"approved": false}
      },
      {
        "id": "workflow_adherence", "default_id": "zzzops.policy.workflow_adherence", "title": "ZzzOps workflow adherence", "required": true, "applicable": true,
        "decision": "tracked", "rationale": "Require durable goal context for substantial agent work while allowing projects to review stricter or lighter routing.",
        "source_ids": ["E-002"], "confidence": "medium", "default_origin": "ZzzOps tracked-work fallback", "default_disposition": "accepted",
        "settings": {
          "levels": {
            "optional": "direct_agent_work_allowed",
            "tracked": "durable_goal_required_for_substantial_agent_work",
            "managed": "zzzops_workflow_required_for_repository_changes"
          },
          "exemptions": ["read_only_investigation", "zzzops_administration"],
          "scoped_exception": "explicit_scoped_user_authority",
          "agents_projection": "review_workflow_reconciliation"
        },
        "exceptions": [], "unresolved": [], "review": {"approved": false}
      },
      {
        "id": "automated_design", "default_id": "zzzops.policy.automated_design", "title": "Automated design authority", "required": true, "applicable": true,
        "decision": "enabled", "rationale": "Allow unattended execution to resolve low-commitment in-scope design choices when reviewed project evidence is decisive, escalate high-commitment choices through early evidence, and retain hard authority gates.",
        "source_ids": ["E-002"], "confidence": "medium", "default_origin": "ZzzOps bounded-commitment automated-design fallback", "default_disposition": "accepted",
        "settings": {
          "scope": "bounded_commitment_in_scope_implementation",
          "commitment": {
            "low": "replace_verify_and_clean_within_one_goal_before_fanout",
            "high": "compare_evidence_cost_signal_or_explicit_current_design_review",
            "structural_cost_signals": ["affected_goal_units", "started_descendant_branches", "started_descendant_prs", "durable_data", "public_or_integration_contracts", "external_state", "compatibility_paths", "verification_breadth", "clean_removal_path"]
          },
          "selection_basis": ["project_objectives", "kpi_evidence", "constraints", "precedence"],
          "decision_record": ["alternatives", "rationale", "assumptions", "falsifiable_validation_signal"],
          "privacy_security": "unambiguously_risk_reducing_without_material_behavior_change",
          "hard_stops": ["product_scope", "incompatible_public_contract", "destructive_migration", "external_spending", "deployment", "external_write", "human_review", "safety_authority", "higher_authority"],
          "insufficient_evidence": "durable_design_blocker"
        },
        "exceptions": [], "unresolved": [], "review": {"approved": false}
      },
      {
        "id": "autonomy_approval_parallelism", "default_id": "zzzops.policy.autonomy_approval_parallelism", "title": "Autonomy, approvals, and parallelism", "required": true, "applicable": true,
        "decision": "Interview adaptively during goal capture; execute unattended by persisting consequential questions as durable blockers; refill valuable bounded work; use up to three worktree workers below 100 MB and read-only workers otherwise.", "rationale": "balances precise capture, unattended execution, authority, bounded valuable refill, and predictable repository resource cost",
        "source_ids": ["E-002"], "confidence": "medium", "default_origin": "ZzzOps conservative fallback", "default_disposition": "accepted",
        "settings": {
          "blocker_interview": "capture_only",
          "blocker_order": ["safety_access_human", "cross_goal_decisions", "specification", "technical_unknown"],
          "requirements_interview": {
            "capture_depth": "standard",
            "mode": "adaptive",
            "stakeholder_model": "requesting_user_only",
            "execution_questions": "durable_blockers_only"
          },
          "project_parallel_ceiling": "size_aware", "max_workers": 3, "claim_ttl_hours": 4,
          "parallelization": {
            "measurement": "existing_git_tracked_worktree_bytes", "threshold_bytes": 104857600,
            "below_threshold_mode": "worktrees", "at_or_above_threshold_mode": "read_only"
          },
          "dependency_implementation_gate": "stack_from_reviewed_checkpoint", "read_only_dependency_investigation": true,
          "execution_reports": {"enabled": true},
          "resource_reservations": {
            "mode": "conflict_tolerant",
            "exclusive_prefixes": ["generated", "external"],
            "exclusive_resources": []
          },
          "worktree_lifecycle": {
            "after_task": "remove_or_retain_clean_for_reuse", "abandoned_or_dirty": "forbidden",
            "reuse_requires": ["clean_state", "reviewed_base", "new_goal_resources", "safe_branch_reassignment"]
          },
          "refill": {"enabled": true, "allowed_categories": ["documentation", "tests", "code_quality_non_behavioral"], "max_per_run": 3},
          "capture_defaults": {"priority": "P2", "difficulty": "unknown", "confidence": "low"},
          "planning": {"decompose_at": "L", "max_depth": 3}
        },
        "exceptions": [], "unresolved": [], "review": {"approved": false}
      }
    ]
  }
}