From 0df69d744fc55e4896ed6af4f59805f6eac8aba4 Mon Sep 17 00:00:00 2001 From: Wolfe-Jam Date: Fri, 22 May 2026 23:07:56 -0400 Subject: [PATCH] Master template: cohort credibility badges + citation + IANA drift fix MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Applies the master template locked on Wolfe-Jam/faf#10: - Cohort 2+2 badges at top of README (IANA pair + DOI pair, both-formats class): [IANA: vnd.faf+yaml][IANA: vnd.fafm+yaml] [DOI: Context paper][DOI: Memory paper] - New CITATION.cff (CFF 1.2.0) โ€” preferred-citation = Context paper, references += Memory paper. - New ## Citation section with both papers + BibTeX. - IANA-singular drift fix: Line 1 stamp now says 'CLI for the .faf and .fafm IANA-registered formats' Line 278 lists both vnd.faf+yaml (Context) and vnd.fafm+yaml (Memory) Per feedback-update-via-repos-canonical-channel โ€” same canonical pattern across all FAF cohort repos. ๐Ÿค– Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.7 (1M context) --- CITATION.cff | 47 +++++++++++++++++++++++++++++++++++++++++++++++ README.md | 41 +++++++++++++++++++++++++++++++++++++++-- 2 files changed, 86 insertions(+), 2 deletions(-) create mode 100644 CITATION.cff diff --git a/CITATION.cff b/CITATION.cff new file mode 100644 index 00000000..f5fdcaf7 --- /dev/null +++ b/CITATION.cff @@ -0,0 +1,47 @@ +cff-version: 1.2.0 +type: software +message: "If you use faf-cli or the .faf / .fafm IANA-registered formats in your work, please cite the format papers in `preferred-citation` and `references` below." +title: "faf-cli โ€” CLI for the .faf and .fafm IANA-registered formats" +authors: + - family-names: Wolfe + given-names: James + orcid: "https://orcid.org/0009-0007-0801-3841" + affiliation: "FAF Foundation" +license: MIT +repository-code: "https://github.com/Wolfe-Jam/faf-cli" +url: "https://faf.one" +keywords: + - .faf + - .fafm + - CLI + - AI agent context + - AI agent memory + - IANA-registered format +preferred-citation: + type: article + title: "Format-Driven AI Context Architecture: The .faf Standard for Persistent Project Understanding" + authors: + - family-names: Wolfe + given-names: James + orcid: "https://orcid.org/0009-0007-0801-3841" + affiliation: "FAF Foundation" + year: 2025 + month: 11 + doi: 10.5281/zenodo.18251362 + url: "https://doi.org/10.5281/zenodo.18251362" + publisher: + name: "Zenodo" +references: + - type: article + title: "Permanent Memory and Instant Recall: The .fafm Standard for Multi-Profile AI Agent Memory" + authors: + - family-names: Wolfe + given-names: James + orcid: "https://orcid.org/0009-0007-0801-3841" + affiliation: "FAF Foundation" + year: 2026 + month: 5 + doi: 10.5281/zenodo.20348942 + url: "https://doi.org/10.5281/zenodo.20348942" + publisher: + name: "Zenodo" diff --git a/README.md b/README.md index 18f1d6b4..56c04bc7 100644 --- a/README.md +++ b/README.md @@ -1,4 +1,4 @@ - +
@@ -178,6 +178,10 @@ Run `faf --help` for full options. ```bash # ANY GitHub repo โ€” no clone, no install, 2 seconds + +[![IANA: vnd.faf+yaml](https://img.shields.io/badge/IANA-vnd.faf%2Byaml-00D4D4)](https://www.iana.org/assignments/media-types/application/vnd.faf+yaml)[![IANA: vnd.fafm+yaml](https://img.shields.io/badge/IANA-vnd.fafm%2Byaml-00D4D4)](https://www.iana.org/assignments/media-types/application/vnd.fafm+yaml) +[![DOI: Context paper](https://img.shields.io/badge/DOI-Context%20paper-FF6B35)](https://doi.org/10.5281/zenodo.18251362)[![DOI: Memory paper](https://img.shields.io/badge/DOI-Memory%20paper-FF6B35)](https://doi.org/10.5281/zenodo.20348942) + bunx faf-cli git https://github.com/facebook/react # Your own project @@ -271,10 +275,43 @@ If `faf-cli` has been useful, consider starring the repo โ€” it helps others fin --- + +## Citation + +If you use `faf-cli` or the `.faf` / `.fafm` formats in research or production, please cite the format papers: + +> Wolfe, J. (2025). *Format-Driven AI Context Architecture: The .faf Standard for Persistent Project Understanding*. Zenodo. https://doi.org/10.5281/zenodo.18251362 + +> Wolfe, J. (2026). *Permanent Memory and Instant Recall: The .fafm Standard for Multi-Profile AI Agent Memory*. Zenodo. https://doi.org/10.5281/zenodo.20348942 + +### BibTeX + +```bibtex +@article{wolfe2025faf, + title = {Format-Driven AI Context Architecture: The .faf Standard for Persistent Project Understanding}, + author = {Wolfe, James}, + year = {2025}, + month = {nov}, + publisher = {Zenodo}, + doi = {10.5281/zenodo.18251362}, + url = {https://doi.org/10.5281/zenodo.18251362} +} + +@article{wolfe2026fafm, + title = {Permanent Memory and Instant Recall: The .fafm Standard for Multi-Profile AI Agent Memory}, + author = {Wolfe, James}, + year = {2026}, + month = {may}, + publisher = {Zenodo}, + doi = {10.5281/zenodo.20348942}, + url = {https://doi.org/10.5281/zenodo.20348942} +} +``` + ## License MIT โ€” Free and open source -**IANA-registered:** [`application/vnd.faf+yaml`](https://www.iana.org/assignments/media-types/application/vnd.faf+yaml) +**IANA-registered:** [`application/vnd.faf+yaml`](https://www.iana.org/assignments/media-types/application/vnd.faf+yaml) (Context Layer) ยท [`application/vnd.fafm+yaml`](https://www.iana.org/assignments/media-types/application/vnd.fafm+yaml) (Memory Layer) *format | driven ๐ŸŽ๏ธโšก๏ธ [wolfejam.dev](https://wolfejam.dev)*