AOrobator

CI Spec Example: Job Documentation

This example shows how to document CI jobs so that failures are self-explanatory. Each job links back to why it exists and how to fix common failures.

---

Prisma Validation

Why this exists: Per post-mortem 2025-12-25_migration-ordering-failure.md: Two migrations were out of order. Prisma replays migrations into a shadow

AOrobator

System Spec Example: API Contract

This example shows how to document an API contract before implementation. Define the request shape, success response, and every error code upfront. The AI gets everything it needs in one place.

---

API Contract: POST /invoices

Request

AOrobator

Product Spec Example: User Registration Flow

This example shows how to document a user flow in your PRODUCT_SPEC.md. Notice how it covers happy paths, sad paths, and constraints—giving the AI everything it needs to implement without guessing.

---

User Registration Flow

Happy Path

1. User enters email on /login

AOrobator

Keybase proof

I hereby claim:

• I am aorobator on github.
• I am andreworobator (https://keybase.io/andreworobator) on keybase.
• I have a public key ASBSFSWfRoop0N1OL3bAkeXhPbjwcvvcb8Vl8Dolnuqa7Qo

To claim this, I am signing this object:

AOrobator

import okhttp3.mockwebserver.MockWebServer
import okhttp3.mockwebserver.RecordedRequest
import org.amshove.kluent.`should equal`

/**
 * OkHttp3 extensions for syntactic sugar while testing
 */
enum class HttpMethod {
    DELETE,
    GET,

AOrobator

fun realmTransactionSync(transaction: (Realm) -> Unit) {
  val realm = Realm.getDefaultInstance()
  var canceled = false
  realm.beginTransaction()

  try {
    transaction(realm)
  } catch (e: Exception) {
    e.printStackTrace()
    realm.cancelTransaction()

AOrobator

override fun scanSongIntoLibrary(filePath: String): SongId {
   var newSongId: SongId = InvalidSongId
    realmTransaction {
      if (getSongForFilepath(it, filePath) == null) {
        val song = Song {
          id = Database.getNextId(it, Song::class.java)
          newSongId = // get next ValidSongId
          // Initialize title, artist, and album for the song
        }
        it.copyToRealm(song)

AOrobator

fun realmTransaction(onError: (Throwable) -> Unit = {}, transaction: (Realm) -> Unit) {
  val realm = Realm.getDefaultInstance()

  try {
    realm.executeTransactionAsync { transaction(it) }
  } catch (e: Exception) {
    onError(e)
  }

  realm.close()

AOrobator

class RealmSongRepository : SongRepository {
  override fun addSongToLibrary(filePath: String): Single<SongId> {
    return Single.fromCallable {
      scanSongIntoLibrary(filePath)
    }
        .subscribeOn(io())
        .observeOn(mainThread())
  }

  override fun scanSongIntoLibrary(filePath: String): SongId {

AOrobator

  @Test
  fun `When unscanned song clicked, song is scanned into library`() {
    val presenter = FolderBrowsingPresenter(queue, MockSongRepository())
    val target: FolderBrowsingPresenter.Target = mock()

    presenter.attach(target)
    presenter.onUnscannedSongClicked(
        DirectoryItemSong(
            name = "01 Get You.m4a",
            lastModifiedTime = 1234L,