fix: Restore original README content

The previous RSR standardization commit accidentally replaced the full
README content with a minimal template. This restores the original
project documentation.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

Author: Jonathan D.A. Jewell

README.adoc

@@ -1,76 +1,246 @@
-= conflow
-Jonathan D.A. Jewell <jonathan.jewell@gmail.com>
-:toc: macro
+= conflow - Configuration Flow Orchestrator
+:toc: left
+:toclevels: 3
 :icons: font
 :source-highlighter: rouge
-:experimental:
-:url-github: https://github.com/hyperpolymath/conflow
-:url-gitlab: https://gitlab.com/hyperpolymath/conflow
-:url-bitbucket: https://bitbucket.org/hyperpolymath/conflow
-:url-codeberg: https://codeberg.org/hyperpolymath/conflow
 
-Configuration flow orchestration with formal verification
+Intelligently orchestrate CUE, Nickel, and configuration validation workflows.
 
-image:https://img.shields.io/badge/RSR-Certified-gold[RSR Certified]
-image:https://img.shields.io/badge/License-AGPL%20v3-blue[License]
+image:https://img.shields.io/badge/RSR-Silver-silver[RSR Compliance, link=https://gitlab.com/hyperpolymath/rhodium-standard-repositories]
+image:https://img.shields.io/badge/License-MIT%20OR%20Apache--2.0-blue[License]
+image:https://img.shields.io/badge/Rust-1.75+-orange[Rust Version]
 
-toc::[]
+== Why conflow?
 
-== Overview
+*Problem:* You have configuration files and you're not sure whether to use CUE, Nickel, or both.
 
-conflow is part of the link:https://rhodium.sh[Rhodium Standard] (RSR) ecosystem.
+*Solution:* conflow analyzes your configs, recommends the right tool, and orchestrates the entire pipeline.
 
-Domain: *configuration-management*
+[source,bash]
+----
+# Instead of:
+nickel export config.ncl > temp.json
+cue vet schema.cue temp.json
+cue export schema.cue --out yaml > deploy.yaml
+rm temp.json
+
+# Just:
+conflow run
+----
+
+== Features
 
-== Installation
+* *Intelligent analysis* - Recommends CUE vs Nickel based on complexity
+* *Pipeline orchestration* - Chain tools with dependency management
+* *Smart caching* - Only re-run what changed
+* *Educational* - Learn why certain tools fit certain problems
+* *Type-safe* - Catch errors before deployment
+* *RSR Integration* - Full Rhodium Standard Repository compliance checking
+
+== Quick Start
 
 [source,bash]
 ----
-# Clone from GitHub (primary)
-git clone {url-github}
+# Install
+cargo install conflow
+
+# Initialize
+conflow init my-project
+
+# Analyze existing configs
+conflow analyze config.yaml
+
+# Run pipeline
+conflow run
+----
 
-# Or from mirrors
-git clone {url-gitlab}
-git clone {url-codeberg}
+== Example Pipeline
+
+[source,yaml]
+----
+# .conflow.yaml
+version: "1"
+name: "k8s-deployment"
+
+stages:
+  - name: "generate"
+    tool:
+      type: nickel
+      command: export
+      file: config.ncl
+    output: generated/config.json
+
+  - name: "validate"
+    tool:
+      type: cue
+      command: vet
+      schemas: [schemas/k8s.cue]
+    input:
+      from_stage: generate
+    depends_on: [generate]
+
+  - name: "export"
+    tool:
+      type: cue
+      command: export
+      out_format: yaml
+    input:
+      from_stage: generate
+    depends_on: [validate]
+    output: deploy/k8s.yaml
 ----
 
-== RSR Stack
+[source,bash]
+----
+$ conflow run
+✓ generate (0.08s)
+✓ validate (0.05s)
+✓ export (0.03s)
 
-This project follows RSR conventions:
+Pipeline completed in 0.16s
+----
 
-* ✅ ReScript for frontend/logic
-* ✅ Deno for JS runtime
-* ✅ WASM for performance-critical code
-* ✅ Rust/OCaml/Haskell for systems/proofs
-* ✅ Guile/Scheme for configuration
-* ❌ No TypeScript
-* ❌ No Go
-* ❌ No npm
+== When to Use What?
 
-== Mirrors
+=== Use CUE when:
+
+* ✅ Validating configuration
+* ✅ Expressing constraints
+* ✅ Merging configurations
+* ✅ Simple transformations
+
+=== Use Nickel when:
+
+* ✅ Generating configurations
+* ✅ Complex logic needed
+* ✅ Functions and abstraction
+* ✅ DRY configuration
+
+=== Use Both when:
+
+* ✅ Nickel generates → CUE validates
+* ✅ Complex generation + strict validation
+
+== Commands
 
 [cols="1,2"]
 |===
-| Platform | URL
+|Command |Description
+
+|`conflow init [--template <name>]`
+|Initialize project
+
+|`conflow analyze <files>`
+|Analyze config files
+
+|`conflow run [--stage <name>]`
+|Execute pipeline
+
+|`conflow watch`
+|Watch mode
+
+|`conflow validate`
+|Validate pipeline
+
+|`conflow graph [--format <fmt>]`
+|Show pipeline graph
+
+|`conflow cache stats`
+|Cache statistics
 
-| GitHub (primary) | {url-github}
-| GitLab | {url-gitlab}
-| Bitbucket | {url-bitbucket}
-| Codeberg | {url-codeberg}
+|`conflow cache clear`
+|Clear cache
+
+|`conflow rsr check`
+|Check RSR compliance
+
+|`conflow rsr requirements`
+|List RSR requirements
 |===
 
+== Templates
+
+[source,bash]
+----
+conflow init --template cue-validation     # Simple CUE validation
+conflow init --template nickel-generation  # Nickel config generation
+conflow init --template full-pipeline      # Generate → validate → export
+conflow init --template kubernetes         # Kubernetes manifests
+conflow init --template multi-env          # Multi-environment configs
+----
+
+== RSR Compliance
+
+conflow includes full RSR (Rhodium Standard Repository) integration:
+
+* *Compliance checking* - Validate against RSR requirements
+* *Auto-remediation* - Automatically fix common issues
+* *Badge generation* - Generate compliance badges for CI
+* *Diff reports* - Track compliance changes over time
+
+[source,bash]
+----
+# Check compliance
+conflow rsr check
+
+# Auto-fix issues
+conflow rsr check --fix
+
+# Generate badge
+conflow rsr check --badge badge.svg
+----
+
+== Development
+
+[source,bash]
+----
+# Using Nix (recommended)
+nix develop
+
+# Using just
+just build      # Build
+just test       # Run tests
+just check      # Run all checks
+just install    # Install locally
+----
+
+== Documentation
+
+* link:CLAUDE.md[CLAUDE.md] - AI assistant guidance
+* link:CONTRIBUTING.md[CONTRIBUTING.md] - Contribution guidelines
+* link:SECURITY.md[SECURITY.md] - Security policy
+* link:GOVERNANCE.md[GOVERNANCE.md] - Project governance
+* link:CODE_OF_CONDUCT.md[CODE_OF_CONDUCT.md] - Code of conduct
+
+== RSR Standards
+
+This project follows link:https://gitlab.com/hyperpolymath/rhodium-standard-repositories[Rhodium Standard Repository] guidelines:
+
+* ✅ Memory-safe language (Rust)
+* ✅ Offline-first design
+* ✅ Reproducible builds (Nix)
+* ✅ Comprehensive documentation
+* ✅ SPDX license headers
+* ✅ Security policy
+* ✅ TPCF contribution framework
+
 == License
 
-Licensed under AGPL-3.0-or-later OR LicenseRef-Palimpsest-0.5.
+This project is dual-licensed under:
+
+* MIT License
+* Apache License, Version 2.0
 
-See link:LICENSE[LICENSE] for details.
+See link:LICENSE.txt[LICENSE.txt] for details.
 
 == Contributing
 
-See link:CONTRIBUTING.adoc[CONTRIBUTING.adoc].
+Contributions are welcome! Please read our link:CONTRIBUTING.md[Contributing Guide] first.
 
-== Metadata
+== Links
 
-* Domain: configuration-management
-* Framework: RSR (Rhodium Standard Repository)
-* Dublin Core: link:.well-known/dc.xml[.well-known/dc.xml]
+* *Repository:* https://gitlab.com/hyperpolymath/conflow
+* *Issues:* https://gitlab.com/hyperpolymath/conflow/-/issues
+* *CUE:* https://cuelang.org
+* *Nickel:* https://nickel-lang.org
+* *RSR:* https://gitlab.com/hyperpolymath/rhodium-standard-repositories