hooman

Chat-First Project Development with LLMs

Working title — pick a real name when this gels.

Status: Draft v0.2 (May 21, 2026). Updated from v0.1 with: anti-bureaucracy guardrail, doc-audience layering principle, handbook artifact, glossary discipline and naming rules, findings-from-chat pattern, and refined operating rules. Distilled from one project's experience; will evolve as the methodology gets stress-tested across more projects.

Canonical version: https://gist.github.com/hooman/5811ee3bb7c235573299400167403985. Local copies may lag; treat the gist as authoritative.

---

hooman

Contributor License Agreement

By signing this CLA, you agree that:

1. You retain copyright over your contributions.
2. You grant the Iran Transition Project a perpetual, worldwide, non-exclusive, royalty-free license to use, reproduce, modify, and sublicense your contributions as part of this project.
3. You confirm your contribution is your original work and you have the right to grant this license.

hooman

// A small set of utilities for working with Unicode and ASCII scalars. Here is what it does:
// 
// 1. Make `UnicodeScalar` strideable. This enables ranges of Unicode Scalars such as "a"..."z".
// 2. Add strideable Unicode.ASCII.Scalar (type alias `ASCII`) to enable type-safe manipulation of ASCII bytes. 
// 3. Define limited `+`/`-` operators for stridable types to make something like `"x" + ("A"-"a")` possible.


// 1. Make `UnicodeScalar` strideable. This enables ranges of Unicode Scalars such as "a"..."z".

// Constants used in `Strideable` conformance extension of `Unicode.Scalar`

hooman

//: Playground - noun: a place where people can play


/// A protocol to provide an abstraction of types that hold a weak reference to a target object.
///
/// It is defined because a single generic implementation cannot support existentials, as they
/// do not conform to themselves or `AnyObject`. Most of its API is defined by protocol extensions
/// to makes it easier to create existential wrapper `struct`s or `final class`es.
///
/// Here is an example protocol and the corresponding weak reference

hooman

// An operator for tuple splat of simple function arguments (up to six arguments implemented).
// by Hooman Mehr (hooman@mac.com)
// Source released as public domain.

precedencegroup TupleSplatPrecedence {
    associativity: left
    higherThan: BitwiseShiftPrecedence
}

// Infix operator for on the fly tuple splat:

hooman

//
//  HTMLBuilder.swift
//
//  This is a prototype code of a DSL to make it easier to generate HTML within Swift source code.
//
//  This version of the prototype usues global constants for html elements because of a compiler limitation / bug.
//  The intended behavior was having these globals static properties of `Html` type.
//
//  Created by Hooman Mehr on 04/07/17.
//  Copyright © 2017 Hooman Mehr. See the MIT license at the bottom.

hooman

import Darwin

public protocol MutexValue {
    
    mutating func lock()
    
    mutating func locked() -> Bool
    
    mutating func unlock()
    

hooman

// RationalNumber.swift
//
// A basic implementation of Rational numbers in Swift 3.0.
// (c) 2016 Hooman Mehr. Licensed under Apache License v2.0 with Runtime Library Exception



/// A data type to model rational numbers in Swift.
///
/// It always uses fully-reduced representation for simplicity and clarity of comparisons and uses LCM

hooman

//
//  CollectionIndexExtensions.swift
//  Swift3
//
//  Created by Hooman Mehr on 5/9/16.
//  Copyright © 2016 Hooman Mehr. See the MIT license at the bottom.
//

hooman

//
//  KeyValueStore.swift
//  FoundationNG
//
//  Created by Hooman Mehr on 4/27/16.
//  Copyright © 2016 Hooman Mehr. See the MIT license at the bottom.
//