From a5366dbca88c2a975c832f8644f0df01e043a457 Mon Sep 17 00:00:00 2001
From: Jonathan Miller <jmiller-moko@noreply.git.mokoconsulting.tech>
Date: Tue, 23 Jun 2026 10:28:34 -0500
Subject: [PATCH] =?UTF-8?q?feat:=20initial=20setup=20=E2=80=94=20README,?=
 =?UTF-8?q?=20CHANGELOG,=20CLAUDE.md,=20submodules,=20workflows?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 CHANGELOG.md | 14 ++++++++++++++
 CLAUDE.md    | 31 +++++++++++++++++++++++++++++++
 README.md    | 12 ++++++++++--
 3 files changed, 55 insertions(+), 2 deletions(-)
 create mode 100644 CHANGELOG.md
 create mode 100644 CLAUDE.md

diff --git a/CHANGELOG.md b/CHANGELOG.md
new file mode 100644
index 0000000..755b1c5
--- /dev/null
+++ b/CHANGELOG.md
@@ -0,0 +1,14 @@
+<!--
+ Copyright (C) 2026 Moko Consulting <hello@mokoconsulting.tech>
+ SPDX-License-Identifier: GPL-3.0-or-later
+ INGROUP: MokoSuiteLibrary.Documentation
+ BRIEF: Version history using Keep a Changelog
+-->
+
+# Changelog
+
+## [Unreleased]
+
+### Added
+- **Repository** — initial repo creation with dev branch, topics, workflows
+- **Roadmap Issue** — implementation roadmap with full feature checklist
diff --git a/CLAUDE.md b/CLAUDE.md
new file mode 100644
index 0000000..8c69ced
--- /dev/null
+++ b/CLAUDE.md
@@ -0,0 +1,31 @@
+# MokoSuiteLibrary
+
+Library and resource lending management for Joomla 6 — catalog, checkout, returns, reservations, overdue tracking, fines, OPAC.
+
+## Quick Reference
+
+| Field | Value |
+|---|---|
+| **Package** | `pkg_mokosuitelibrary` |
+| **Layer** | 2 (requires: Client → CRM) |
+| **Language** | PHP 8.3+ |
+| **Branch** | develop on `dev`, merge to `main` (protected) |
+| **Wiki** | [MokoSuiteLibrary Wiki](https://git.mokoconsulting.tech/MokoConsulting/MokoSuiteLibrary/wiki) |
+
+## Architecture
+
+Joomla **package** — Layer 2 add-on. CRM contacts serve as library patrons.
+
+## Rules
+
+- **Never commit** `.claude/`, `.mcp.json`, `TODO.md`, `*.min.css`/`*.min.js`
+- **Attribution**: `Authored-by: Moko Consulting`
+- **Workflow directory**: `.mokogitea/`
+- **Standards**: [MokoStandards](https://git.mokoconsulting.tech/MokoConsulting/MokoCLI/wiki)
+- **Changelog**: `[Unreleased]` only — release system assigns versions
+
+## Coding Standards
+
+- PHP 8.3+ / Joomla 6 patterns
+- `$this->getDatabase()` in models, `Factory::getContainer()->get(DatabaseInterface::class)` in helpers
+- `Factory::getApplication()->getIdentity()` for user
diff --git a/README.md b/README.md
index 9c7b300..15bb6b2 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,11 @@
-# MokoSuiteLibrary
+# MokoSuite Library
 
-Library and resource lending management for Joomla 6 — catalog, checkout, returns, reservations, overdue tracking, fines
\ No newline at end of file
+Library and resource lending management for Joomla 6 — catalog, checkout, returns, reservations, overdue tracking, fines.
+
+**Layer 2** add-on for [MokoSuite](https://git.mokoconsulting.tech/MokoConsulting). Standalone (optional CRM integration for patron contacts).
+
+## Links
+
+- [Wiki](https://git.mokoconsulting.tech/MokoConsulting/MokoSuiteLibrary/wiki) · [Issues](https://git.mokoconsulting.tech/MokoConsulting/MokoSuiteLibrary/issues) · [Releases](https://git.mokoconsulting.tech/MokoConsulting/MokoSuiteLibrary/releases)
+
+GPL-3.0-or-later · Copyright © 2026 [Moko Consulting](https://mokoconsulting.tech)