tenet 04

Folders are architecture

A project's structure should be readable without running it.

The structure of a project is a decision, and a decision should be visible. I number the stages of a project and keep one short contract file in each stage. A person or an agent can open a folder and see the job, the inputs and the outputs without running anything.

The method is the Interpretable Context Methodology, by Jake Van Clief and David McDermott, and I follow it in my own projects. ICM Doc is my markdown-only tool for checking and building that structure. This site is organised the same way, one folder per section, so the pages match the work behind them.

..::::----::::::----:... ....:::--==it+==-|-:|:........::::--------===s **t go on the p*+e. A+==-----::::::::::----======= +**++\#/==--|==|+* tw ...:::--------::----::... .....:::--==++===-|--|:....../::::----------=== +*public repos*++ry wi==-------:::::::-----====---****+-%%%%#===|==|+**** .....::::-------:::--::::.........:::--======--|--|:::::::|:::------------=== +ead. T\-----e|is st=------------***#@@@@@@@@@@@@@@@@@%%%%%===|= |o++++ ::...::::::-----::::-:::::::.....::::---====---|--|-:::::::::--------------==++ck\- link *# a|---****@@@@@@@@@@@@@@@@@@@@@@@@@@---wo+d /\=+it|is|a wor -::::::::::-----:::::::::::::::::..:::--====---|==|-------::---------------=\-e*t and re#%%==%%%@@@@@@@@@@@@@@@@---=-=====+ been shown.+++ost|of|===== ---:::::::::---::::::::::::::::::...::------===|==|=-------------------:--\===e+******##%%%==#@@@---==. I+=====/a+====/===+ +*++us+===++alter|at|=-=== =---::..:::::::::::::::::::::::::...:-------===|++|===-----=--:::---:::\:--\==t+***++++%%+e==+d and r===---=rst t==e. -=/=+t+**+e======+t dra|ti|----= ==---:::::::::::::::::::::::---:::..:-------===|r |====--====--:----:\::----==+ +++re a c+===ilit++is ==t pr+==+ i+==y *==/w+**+y======+h as |ig|----= ===--::::::::::::::::::::-------:::::-------===|+r|==========------\::--:----==ounding it +++ Y+++ mach===-=you+==at*-=y*=+/++y=========e st|c=|=---= +===----::::::::::::------------:::::---------=|==|==========----\::--::-----===uld belong to me +++*+r=== po+==ble*=th*==i*=+/===========+th|==|===== d+===----:::.....:::-------------::::----------|==|===========----:-:::--:----==++e work that do+++*** nee= ==e b+=ge*= m*=el#===-=========++|==|===== ol+===---:::......::-------------:::-----------|==|===========\----::--::----=========+It says++he dec+s=== is =ine*=an#=th*=//=-/===========|==|===== ch+===---:::......:::--------:::::-------:::::-|==|==========\=---::-::--:--============Ollam+******s**+ith=+=ste+ mo*=l* =s#-n o-|=======---|--|===== rc+===---:::......::::-----:::::::------::::::-|==|==========\==----::--:---=============of ++******t is a dec+sion, a*= a#=e#=si+=/======---|--|-==== I+===---:::......::::----::::::::------::::::-|-=|=============---::-::----=============+ or an age***+an =pen a fo*=er*an#=s#= t==/====----|--|-==== ++===----:::......::::-------:::::-------:::::-|==|========|===---::-::--:-===============+gy+******** Van*Cli+f a#d D=vi* M#=e#-o#==/===----|--|-==== =====------::.....::---:::----:::::::----------|==|=======\====--::-::--:----===============+.+++++++**e*is=*rg=*is*d t=e +am#=w#=,#=|==-----|--|===== =====------:::::::::---:::----:::::::----------|==|============--:--:--::---=-===============tory an+****##te=*p.# A*pr+=e*= *= f==i==|------|--|===== =====-------::::::::--::::----:::::-----=======|==|====++\======---::-::=--=--================+++clo++****#\ w=*t=*up#th#t #=y#=w#=t*=|------|--|===== =====------------:::--:::::--:::::-----========|=+|+++es |t++====--:--:-------=====|=============t. +*****## p=+l=sh =ne=w+=h*-t*-h*-|------|--|--=== =====--------==---:---:::::::::::------======++|++|site links +==-----:=--=--=--==-------========+ibi+++****##r=* m*mo+y. T=e ==a=----|-----|--|----= =====-------===-------:::::::::::------=====+i+|=+|+ new depe+====--=::=:-=--=--o-|------=========+cy i++*****bi+it* w*th+= v=r+=o==n=|--:::-|--|----= =====-------===--------::::::::::------=====+o+|==|======|=======---=::=--=--=-- ---------=========+ no=++***=encies. K=ys= f=o==e=-,=--:::::|--|--=== =====--------==--------:::::::::::-----=====++=|==|=====|----=------=::=--=--=--s----------==========+ntry+++*t =se= i=. ==e==n==y-=a--::::::|:-|-==== ==----------------------::::::::::-----========|==|======|===---------:-------=:-=:---------===========+n ri-=.=-L=-r=-ng-is-n+-e*-=*-|::::::|::|-==== ------------------------:::::::::::-----=======|==|==----|----:-::------=--=--+-:==:\------:--============+ind=- p==w==l=-r+- p-og-es-|::::::|:-|-==== ------------------------::::::::::::----=======|==|=---------::-::------==--=--o-:==:----------============- =-=r=-a=- =- a-=o-=t=- --|::::::|:-|-==== -------------------------::::...:::::----======|==|=-----:|::-::-::--=====---=--+-::u-:-:--------======:=-, =-e --a=-i+-=i--p=-t==f -|-::::::|::|-==== -------------------------::::...:::::----======|==|-----::/::-::--:---=====---=-:- -:: =---::------====- i-:=S=-=n=-u+--.=-P=-=f==v--\-::::::|:-|-==== -------------:-----------::::::::::::----======|==|-------:/::-::-:-----=---=--==::-l-::-+p=--:::--=ea=-::=t=:-i=--h=:=o-:i=-= -- --\-:::::::|--|===== -------------::----------::::::::::::----======|==|---------/::-::-::--------=-::==:::=a=-::::::-:::::-=e=-:-A=-:=a-: +:-r=-=a--r\\\--::::---|--|===== ------------:::----------:::::::::::----=======|--|----------:::-::--::=:::=--:=-::-m=::::-=s site h=-:::-li-::=n-:-o-:=a--==--n--|--::::----|--|===== ------------::::--=-------::::::::::----======-|--|---====---:|:://::-:::-:::=-::-=-:::- ==-::::-----=s =-::-s=::-a=:-o=:-o=--o--|--::::-----|-=|===== ------------:::---=====---::::::::::---======--|--|--======--::::::-::--::--:::=-:::-==-:::::::-------::-=e=:::= -:-t=::==--==--\-::::::-----|==|===== --::--------:::---======---:::---------======--|--|--===+==--::::/::-:::--:::=-:--==-::::-=========r==--:::-==-::-b=::==::- -=\---:::::----==|==|===== --::--------:::---======---------------=====---|--|--======--:::::::::-:::--:---=-----===---:::--==----=g=-:::-t=:::==::- --\==---:::::---===|==|===== -----------:::::--========--------------=====--|--|--======--:::::::::::--:::------==------------==----:::-==-:::==-::-=-----==------::------|--|===== ----------:::::::--=============--------=====--|--|----==---:::::::::::/::--------======-====-=========--::---==----\=---\--====-------------|--|--=== ---------::::::::---=============-------=====--|--|---------:::::::::::::/::----/-=========-=======------==------=---\\---========-----------|--|----= ::---------::::::---=====+ sa+===-------====---|--|-----------::::---::::::-/--/-===================--------==-----\-=================----:::|--|----= :::---------::::::---====+e th===--------------|--|----------------------:------/=================|=-======-----\-===========+e.++====---::::|--|---== :::----------:::::---====+pen+===-----=--------|--|----\--/--------------------====------=========|=---=-\==================project==\--/::::|--|---== :::----------:::::---=====ng +===--------------|--|-------|---------------------==---===============---=====================tages o==/--:\:::|--|---== :::---------::::::----====+n +===--------------|--|----------------------::------=---==========--------=====-----============+tho+====--:::::|--|---== ::----------::::::-----====ta+===--------------|--|---------------------:::::------============--------====-------====================--:::::|:-|--=== :-----::----::::::------===++====----------===-|-----------:-----::-----::::::----============---------====--------==================---:::::::-|-==== ::---:::-----:::---------======---------======-|----------::-----:::----::::::-----==========-----------==-----------====---------------:::::::-|-==== :::::::::-----------------===----:::---=======------------:::-----:-----:::::::----===-======----::-------------------==---------------:::::::---=====

..::::----::::::----:... ....:::--==it+ .....:::--------::----::..........:::--==++= .....::::-------:::--::::.........:::--===== ::...::::::-----::::-::::::::::::::::---==== -::::::::::-----:::::::::::::::::..:::--==== ---/::::::::---:::::----::::::--#@@@@@@@@--- =---::..:::::-::-*@@=@@@@@@@@--::...:------- ==---:::::\:\\re=-*---==--=c, #+=::::------- ===--:::::-t=::-s you can re*d= %=::------- +===----:n=:-rp=--= If a c*aim %= t//------- h+===-\\=-:=a:-=no--===us li*%* #* s@=------ my+==|-=-:n=:= =-==/t+***#+%A **si#or%------ ec+===-=-==:= --f===sec*##%.+#s*+n#=t%=--:-- ta+=|==--o-: =:r====+s+**##%s% d#al*fo-|::-- o+=\-=--A-:n=: =====, +*+*#s*di*ec+ =|::-- +====----==:+=:=-=====+nd+**+=e+= *-d#---:-- =====--=--t-:a=:-o-=====+-h=-n+= M==t ------ =====---=--i-:-i=::-nd ==--y =-oj==t\\------ =====---/=---e-::= I direc+--=, :=v=-----=== =====------=---s.=-:--:::-=t =:-in-\---===== =====-----/--t=---:-====--::-la\:------===== =====-------==/--ype===ery =-::::------===== ====--------===--------|:-:::::::-------==== =====--------==--------:::::::::::-----===== =-----------------------::::::::::-----===== ------------------------:::::::::::-----==== ------------------------::::::::::::----==== -------------------------::::...:::::----=== -------------------------::::...:::::----=== -------------::----------::::::::::::----=== -------------::----------::::::::::::----=== ------------:::----------::::::::::::----=== ------------::::--=-------::::::::::----==== ------------::::--=====---::::::::::----==== --::--------:::---======--::::---------===== -:::--------:::---======---------------===== --:--------:::::---=======--------------==== ---------::::::::--=============--------==== ---------::::::::---=============-------==== ::---------:::::::---====+ys +===--------=== :::---------::::::---====+her+===----------- :::---------::::::---====+it +===----------- :::---------::::::---=====+un+===----------- :::---------::::::----====+ls+===----------- ::----------::::::-----====A +===----------- ::----::----::::::------========------------ ::---:::-----::::--------======---------====

Folders are architectureFolders are architectureFolders are architecture

Folders are architecture