Skip to content

research(ci): prove a fast-first tier without weakening the final required suite #139

Description

@BaseInfinity

Feedback type

Process improvement from a consumer repository.

Consumer evidence

BaseInfinity/m180-jumpseat PR #111 changed planning documentation and lifecycle contract tests only. Its focused document-learning/roadmap gate passed 36/36 in about five seconds, while the unchanged complete hosted required suite passed 2,141/2,141 in 22m15s. The full gate added valuable clean-Windows confidence, but a cheap contract failure should be visible before spending the entire runner duration.

The same consumer needed a lifecycle-only PR #104 after terminal reconciliation; that seven-file documentation/test change also ran the complete 2,136-test suite locally and in hosted CI.

No source code, private evidence, secrets, or business logic was scanned for this report.

Desired behavior

Research and prove an opt-in fast-first, full-final CI contract:

  1. Run deterministic changed-surface contracts first (for example docs/lifecycle structure, generated-state verification, or directly affected unit tests).
  2. Fail quickly and retain a concise diagnostic when that tier is red.
  3. Keep the repository's complete required suite as the final merge gate; the fast tier must not certify the PR by itself.
  4. Treat cross-cutting files, proof machinery, hooks, dependency manifests, and ambiguous changes as full-suite work immediately.
  5. Record which tier ran, why it was selected, elapsed time, and the exact final gate result.

Acceptance criteria

  • Build synthetic fixtures for docs-only, lifecycle-only, code, hook/proof, dependency, and ambiguous diffs.
  • Prove docs/lifecycle defects fail in the fast tier before the complete suite starts.
  • Prove every merge candidate still receives the declared complete required gate.
  • Prove changed-file classification cannot skip the final gate or silently downgrade ambiguous/cross-cutting changes.
  • Compare wall-clock and runner-time savings against the existing single broad job.
  • Preserve customized consumer workflows; adoption is opt-in.
  • Emit retained failure summaries instead of flooding or truncating the useful diagnostic.

Related

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions