Skip to main content

Foundation

Objective: Establish a working pipeline with a clean architecture that teams can extend, test, and deploy with confidence from day one.

Success Criteria

  • A new contributor can clone the repo, run the pipeline, and see results in under 5 minutes
  • Changes are validated automatically on every push -- no broken builds reach main
  • The codebase is documented well enough that an unfamiliar developer can navigate it without a walkthrough
  • The project supports multiple consumption patterns: one-shot run, scheduled background processing, API access, and command-line queries

Context

Before building advanced features, the pipeline needs a solid foundation. Without clear project structure, automated testing, and CI, every subsequent milestone introduces risk. This milestone de-risks the entire roadmap by ensuring the basics are reliable, documented, and repeatable.

A pipeline that can't be trusted at the foundation level can't be trusted at any level.

Materials

MaterialLocationStatus
Core shared librarysrc/Conduit.Core/Done
Console pipeline runnersrc/Conduit/Done
Background worker servicesrc/Conduit.Worker/Done
REST APIsrc/Conduit.Api/Done
CLI toolsrc/Conduit.Cli/Done
Unit teststests/Conduit.Tests/Done
CI pipeline.github/workflows/ci.ymlDone
Documentation site.github/workflows/docs.ymlDone
Build conventionsDirectory.Build.props, .editorconfigDone

Notes

This milestone is complete. All deliverables shipped and verified.