From e6901e4f6e367e9465501d0950cfd1576c3702d2 Mon Sep 17 00:00:00 2001
From: Tiara Rodney <tiara.rodney@byteb4rb1e.me>
Date: Tue, 10 Feb 2026 20:57:47 +0100
Subject: [PATCH] new

---
 AGENTS.md                        |   6 ++
 CONTRIBUTING.md                  | 100 +++++++++++++++++++++++++++++++
 Makefile                         |   2 +-
 dist/doctrees/AGENTS.doctree     | Bin 28431 -> 31017 bytes
 dist/doctrees/README.doctree     | Bin 44309 -> 44309 bytes
 dist/doctrees/environment.pickle | Bin 27696 -> 28086 bytes
 dist/markdown/AGENTS.md          |  13 +++-
 7 files changed, 118 insertions(+), 3 deletions(-)
 create mode 100644 CONTRIBUTING.md

diff --git a/AGENTS.md b/AGENTS.md
index 53bae1b..475d30b 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -40,3 +40,9 @@ If `dist/markdown/` is not available locally, the specification
 - Do NOT modify the RST source under `src/`.
 - Changes to this specification MUST be made upstream in the vendor
   repository.
+
+## Maintaining This Repository
+
+If you are explicitly invoked to maintain this specification repository
+(building, publishing, or managing URLs), see `CONTRIBUTING.md` for
+instructions.
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
new file mode 100644
index 0000000..d8f7d57
--- /dev/null
+++ b/CONTRIBUTING.md
@@ -0,0 +1,100 @@
+# Contributing to the MIME TODO Specification
+
+This document covers how to maintain the MIME TODO specification repository:
+building, deploying, and managing URLs.
+
+---
+
+## Prerequisites
+
+All build and publish commands run inside a pipenv environment. Install
+dependencies first:
+
+```sh
+pipenv install
+```
+
+---
+
+## Building
+
+### HTML
+
+```sh
+pipenv run make build/html
+```
+
+Output: `build/html/`
+
+### Markdown (agent-consumable)
+
+```sh
+pipenv run make dist/markdown
+```
+
+Output: `dist/markdown/`
+
+### Both + publish
+
+```sh
+pipenv run make all
+```
+
+---
+
+## Publishing
+
+The specification is served from `specs.code.tiararodney.com`. The `publish`
+Makefile recipe deploys both `build/html` and `dist/markdown` via rsync:
+
+```sh
+pipenv run make publish
+```
+
+This uploads to:
+
+```
+root@tiararodney.com:/root/webserver/srv/http/spec.tiararodney.com/mime-todo
+```
+
+The resulting web structure is:
+
+```
+https://specs.code.tiararodney.com/mime-todo/
+├── html/          ← HTML output
+└── markdown/      ← Markdown output (agent-consumable)
+    ├── README.md  ← The specification
+    └── AGENTS.md  ← Agent consumption instructions
+```
+
+---
+
+## URL Management
+
+The following files contain URLs pointing to the web server. If the server
+address, path structure, or spec name changes, update these:
+
+- `AGENTS.md` — the "Consuming the Specification" section lists direct URLs
+
+If this spec is bundled inside another spec (e.g., tiara-gitflow-spec), that
+parent spec's `AGENTS.md` and `CONTRIBUTING.md` will also reference these
+URLs and must be updated accordingly.
+
+---
+
+## Release Process
+
+1. Make changes to `src/README.rst`
+2. Build: `pipenv run make build/html dist/markdown`
+3. Review the output
+4. Commit the source changes and the built `dist/markdown/` output
+5. Publish: `pipenv run make publish`
+
+---
+
+## Rules
+
+- Do NOT modify this spec inside a consuming repository. Changes MUST be
+  made upstream in this repository.
+- The `dist/markdown/` directory is committed so that consuming repositories
+  have access to the agent-consumable output without needing to build.
diff --git a/Makefile b/Makefile
index 4e799c8..f40eef4 100644
--- a/Makefile
+++ b/Makefile
@@ -13,4 +13,4 @@ publish:
 
 
 clean:
-	rm -rv build
+	rm -rv build dist
diff --git a/dist/doctrees/AGENTS.doctree b/dist/doctrees/AGENTS.doctree
index 8bdfec24537f7918d91126d101965e840ebe55b1..dec042ee158190a9b5387d331040005bacfb7f5d 100644
GIT binary patch
delta 4299
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
V`Q^U?l`mlOK9-?4XU7A+{{n4KWoZBa

delta 2608
zcmb7GeQXp(6u;T_K6*fH>9t(x*R_=9uCxWpXHiU>wje3}q^*`v+P%9id&70F?CrLo
z*3U?SxrESJPz<7INK~*&E<uH05TSgDRU(mK1^tge0z?vGVu-%kn{9i^#pplp&6|1e
z_ujnu?aY4s2ikoTnO`yQO%ClbALJ@4_Z)VEJU0HzOi<CIv))YYniW=fCE)Af!(l;I
zv`9*zpWhOYczK5wvGT#d7Ae#RBVVY0ASi4%=J>D{N%n?9K`mmFLb9N!vZO_3Dxxg#
z{+?jS#|NXkb4zlQ*Hvd%M88`3JVNh9m#*qHlP{`wq2y>y&2@xMlex8pbIv52Ohog%
zsts#yF|!Gef!&19leXHW#TWJQB`U?@CVUwNyCNw)J~0sV%YvkJYxoE9N$qNMmE5i^
z1Zl4;%DW0)!y105D{-vBq(+kDutM?iRkE(G82qHVJY*%2y1rDq*<^y`cp}MU!ZSze
z3p2A|MzrAg1+u(;KFT4R>K87u!aAlxwCvPy8nx05i^k#@0IcOuD~Ft{A4X--sx=Bi
zm!hL<?<8k0tI|Ykw<e}Vk`}}G4UO(z%*5}KW9ub!6r_`^Y;2x;001KCLm}Dk3#pP)
z-XD-uMF?y7Nc2!+4qBl`QY5}#P<9N!B;DUx2-t<kba_FSm#9=lCtW=UW6=%09Ssza
z_T~m?#QV)F&^Wo?ydV7z<I;3|i~1Bd*u*07X{czNeA@CHdH@y8ArGpPNnxuy_a1ej
z%f$_L>O#%=;xg5Xe=`%I^$IePC2d{EPWa9RX*P?Fm&))=<U*T=Gg-*7ZLXNgAnpyz
z9VY4qAPm<8U@7FzRu7t&80F^;MKm1ArEXTSks+=e{cI_*%#pjKv3>WZGS`q8@QJPg
zIW!pX3t`tY?TzbQ0m(0H2SX8g#pUBAmshYWGCwHDVZrZGLN3Z^MSyj|#SaVw13umx
z6kPqhywx8Xl3aa(pb)MgzqUIaRf#r|(y<!V(2eA=cBHd*7~ZNExKKuV+snwwju~84
ztUtQSAdfq86T_BwE<qco_h%B89OzugP!fltXFE`chHm(`iah_hU5vx<1>?Blt1JJ1
zALFs$h?lS<Hnul)#DbVbPuB?-!Fiw|FV2OpDi^FVlD*l5F6vD0+FXP7!d^?s{jk}d
z#acgNAy45&98lKM^Ah@q_9C6-aWa>~7V=GxC&e&7AosiSXu#~=FCC{6o%7A!T69iF
zVqMK<NT)1hGrx)hMR~8Q3^LBIp+nf9k=SrQ5ld{ClZij{zTmi<C~>84EqXXTaSls-
z*Fui_mU5t`r7;$7(=?0GB>Z;2pG&urL(QJadmxwLq>@%|<&-BD4ss>&o_Wl39(b0f
z7}g~AzP={z$@qwT7O|2>kQTpf3SZtLaxL-R1<boq$2Y7=d{OM=g!l*-i}33BQXj={
z=`JAGx}A;2nU1h-s@`c-x)?_#dXMsALAR!gg<=U@dW=D$o85Ysfo1L7PMW;JUc{2V
zZZ+s7;UKp^zOrKGw2xM1H!NZ$54v(G!NjeSW7L}XM&yp`ShF#s*nEaHY9%c}CkF~n
zI*l>eSUjR9GOVdYkAk0ZKUsBB>MDaw^v|I)(=bX{f**AZ!vc)f?)*0VB9w`TK|ptK
z7QDI8AY((Xvn|9m_i|iw>GKrV+#(W^i_ioakukaveJop%{)sC0P(Jy5TcIu;WP!Ta
zk#9@TpaIpxRoG$_W(`VW_2-joYB|aukr!~c%w*AErkma)m@)v<N~aNkK9o~;$=Rqp
z_!{DxZRF9=#+ToMwI=*FNVsO+0R=C2zBnU{Pw3-_-K)aiNx2f}7hoZbzt*Sm>6khL
z3V%z*cT`*fAv*E*bo?jO0RJr$vEP@!z=8yiW9sjiLN?PzI-3Mr2XzBnL0Q0RK-fx^
o3EM#786bw?9&OX`6EFm)^q9&3)r1`&aV8a6)CL|Wsosiz0G<Ob`v3p{

diff --git a/dist/doctrees/README.doctree b/dist/doctrees/README.doctree
index 12d1552157173870480c7ec88a1b028a975d6464..69704442aa40830f94ac707fd3a6cc473a568dcf 100644
GIT binary patch
delta 21
ccmbPwi)rdDrU{FgOwA`Q)c}$k&%3Pw0AgGS!T<mO

delta 21
ccmbPwi)rdDrU{FgjEp8O)c}$k&%3Pw0Abb$vH$=8

diff --git a/dist/doctrees/environment.pickle b/dist/doctrees/environment.pickle
index 5dc94bf29c06da50bca7fcb4217e5b031985ad0b..df258b0f10ae2fb61150cb24ce960a5a3b5be0a6 100644
GIT binary patch
delta 1486
zcmZuxZ%kWN6z?sRG6oYVPGuG-V+c%;@@IvD&;kuoXc>JVg8}8yK4>4Mh4ztEk|mpL
zuwkdu-!uEL#5v>C`FGd^V>E%qM4fJteK92Z$wbK(iCZ$45KZQN4=BU<p{MtrbAG?`
zJNMmluPl@KpNZ<2>WvRa=TzUTlof{PP1V${?nHke$O#iczZgjtJVB0iJADBc>k}g>
zA%PXVE+-obaX~?hs9k~4F&`HeBk_ZQ08LP{KJT!f4T+H*-cfeg>t};6Zh8Yl(T~&3
z+O#ju3|&5IP2h{;6pC4O>7wWIXQeL@@<DW}>{B)RE87eA*jTS$pg*sFIJ?8+4P`sH
zu|UWx1Ss1{@wj+Y<j+wwUk}n~!UaQm@#q$!NT7(K;1*(ne_KlaS~4=M4tI@uw3(Ag
zP4up@g2emd6$*@7a$&EjAd@&zbBB!JioFZhpUWU;X_0nR)@sO^7;YA04dYm=%>qme
zM(XmQHHXPN6qAX?+DZ(V%E%3hbKrNA0c8#KxNkfl$J?=D-a}RqS8pZvVXxmGe{Z9B
z`UF2imv;V?Y-OdZFbx#K)R_-;!!zV|to{nEe-^xj0n?a=-z;I}qbkhVwMez}5F_->
z9aymB5d$u^Rg-dR^>|R1Bqf;#jAVtf%8o5XiEfob5gO$Gg0-oFHh-+CASUdw{}JYv
zm<nWNhUW_jD-}}qt1#XWz^>*ToU<~RYR*SWOISI*E=@X@Nvjrrw=lSE-HTA`w$Lvv
zS?I7au($5Rf^A!<-j+uGq)j>Sp6v<phuqYySW}dqHYF7|50pr4%3U2HPvUBq1Cwoe
zWH*jG*1xv~OP%AeAI!iH?F_y=s6(S8tSnBD&u+1{3Lmv+LC-MAbmZZE=Alp}G)yKr
zB6FT#a)}V*9H*;lQVd;3HPKMJb+TQ!)3J|Slrf&p{p8IU<~-H$G8VfSeDZ=0)rZ2$
z`E?DcmMUE6(m~(NKyxS`bKSAfVow!zcIS}?>l(U?$UiZ@HCe;Ftl|7N4fH<tIPq#P
zgW%yJ?C5*=mil{jxYx(v*WRb$?ca>N)z<;W$)Kq}2j4n3ystYMavIr(9eCHNQ%<XK
z)n-&qsWI1Tq{nR<s3x<qOEp4Q6<8g}Bq}7cE!s(XpV?3(b;#@ELQWyz403}LUY}bU
z<4FkY5}AQz@EZ9BkGOOh->K;=iUrb;=gZ@2=dV+joxcIAt6cM=yk3&+`ncT0Yc37>
z371@ZNf_5$S!5ZvTsmrZx^uM4G?Ug@lm9$LEsBXqTreca?8~sab7@|{tyQKZ;uSY%
zNljEJXl=epdMwiDCX#FmxF>vEcC+72AG#TFa7K(Igg7?n@`(IXG{aNO{|ALiE|=)g
z$30t;LKAq&c#5Y*ez&xHd~+v(HyCJ4C+&3jiaSZlqV+=pAxqKEhc6LbLz3QLC^1x&
YR_gWQDVixgoSRPlfztBmxOYMMFXNRB3;+NC

delta 1336
zcmZ{jdrVtZ9LIYueZW-Q=B67CM;WX|rScfoz)&6qMoTMjw*uu+Zrj_(O=+=@q&_er
z?7>zN-S@gjvSjlQjWJsWG%ozHxM)a3<C2*;=i{GE{lgc!IWpp+i|5|bI!*lN^qlYS
z^!xdqbARXDH)Q5ZqIyO3Mrm+X^@)n9s!DyPn#k|FFB;=w0k@NjM)^ogOy&hfIA0*d
zMV=Rv8ZH>{g~DDsbB9MpgM1>RaZxd;bcMq~F_{|*NBCGg5)za5#{3bU^EiWHHy2Eu
z+0a<HzP(|yVa%)+3^@wLLCuxk0>fO@tAw0PO;n%N;PlRAV#AyD1H^$l_1B37Yn!`p
zYDW<n1^0}HjNnFXC5CsdAp(9fJ%?z+Rx(X1UHHC1M-FDI`{}HXnN)&U_u%WsY8-B0
zG2CRtJ&g%6Nlk;~BF37{<O?h|KSn;MNZrP`;8Q9THo-5CM`=Leq7v8o%W%r7$GGWn
z9BpdCZ>B@!wv7C=MMqY$$YmLMBaQs9wHPn7urRjiakC}CQ2APa1v=}MxU@&jd?YPv
z(?N1gDup8I5-ww5R}DSz?OkR6pU0%i=9z7Olr&<vt&VwGg`Z7f955F%VHIAtci}Iy
zo&=>D38132j(87S?O3)H;$1TfPscWtS`v~N$GQ#{i`G)??~nyM&fC@_Ze^i;b`zGY
z3C1fC|4B|+ndH)UQDeNbi1{N;UGCgYZpn#ms$l6E#bQ?hc?hrByHV4vWj3h6wbe4~
z)TnH&W%AYXw<%?d@NE~1W9)X=yAv6CdiNt}VOiYSU4r-71j)zM{>tq2QTu;~5bUL7
zoPx%fmt_cf5$2vl<fP2j_iC9FY4-6n`$(F-sjnE9dss~O>CxVsU{>WxhYq!Ul<g?T
zdwmIV<Zd=~zS^JdtjK_l$<xSJ{>wl)qt?hL%+bgvT<yLe2DLaoz+zxXhs}eDOjC9{
zw;*qb#Rtw}Oblh^x#5Qqa<VAmwD`^`%XeSDAU6(U$+VLi0oN9y#6Fj$&_Ualize54
z13^COjD?*M-W3l7J>r-sIPk0M67k`J`(yGpraan$cQgtG#IkW()eBOu+l13pvI%Ff
z;Mt)&E6-=-G5soL>3k}g=XCq2XM_)lgQ9Q_TlsC;UJ906%Bc$#rI$S@#^Xswh|2Es
zaPwL+kG*_x;XHMrdA^c={N)x!Jed=T##Z+&@FjHLk9;Asq(QEizyCVjM>7g-(qsHx
zgO|KT5B^Ctzd`tKY0g_h2(Eaas92&K1ZnUa_KCtRX|<ABNq-j74zxyc>5AY<-(K=S
m>bx&T$V{p-@D|x<o1#_eAkAwkjm8RNO-1!n#?*>%f%zMCkJoPi

diff --git a/dist/markdown/AGENTS.md b/dist/markdown/AGENTS.md
index f27ba41..e3e2e27 100644
--- a/dist/markdown/AGENTS.md
+++ b/dist/markdown/AGENTS.md
@@ -16,8 +16,11 @@ access. Do NOT parse the RST source under `src/` directly.
 
 If `dist/markdown/` is not available locally, the specification
 (including this `AGENTS.md`) can be retrieved from
-`specs.code.tiararodney.com`, which provides HTML indexes that can be
-traversed to locate the applicable markdown files.
+`specs.code.tiararodney.com`:
+
+- Specification: `https://specs.code.tiararodney.com/mime-todo/markdown/README.md`
+- Agent instructions: `https://specs.code.tiararodney.com/mime-todo/markdown/AGENTS.md`
+- Index: `https://specs.code.tiararodney.com/mime-todo/markdown/`
 
 ## What This Spec Defines
 
@@ -37,3 +40,9 @@ traversed to locate the applicable markdown files.
 - Do NOT modify the RST source under `src/`.
 - Changes to this specification MUST be made upstream in the vendor
   repository.
+
+## Maintaining This Repository
+
+If you are explicitly invoked to maintain this specification repository
+(building, publishing, or managing URLs), see `CONTRIBUTING.md` for
+instructions.