.. meta::
   :description: Collected .. todo:: directives from across balospe.com, gathered in one place by the Sphinx todo extension. The second, machine-collected half of the AnyAims system.
   :keywords: AnyAims, todo, todolist, sphinx.ext.todo, collected todos, AA registry
   :author: LLoL as Laurence Loewe of Laodicea, ClaudeOp46-50Max, and Everyone

.. _post-aa-sphinx-todos:


************************************************************
Collected ``.. todo::`` entries (whole site)
************************************************************

This page is the **single collection point** for the ``.. todo::`` directives scattered
through the site's content pages. It is the machine-collected half of the AnyAims system:

- an **AA file** is a written, prioritised task list, placed next to the thing it plans;
- a **``.. todo::`` directive** is an in-place marker inside a content page, dropped where
  the work is needed. This page gathers them automatically.

Both are AnyAims. The difference is that a ``.. todo::`` needs no file of its own --- you
write it where you notice the problem, and it shows up here.

.. note::

   ``sphinx.ext.todo`` is enabled in ``source/conf.py`` with ``todo_include_todos = True``,
   so the directives render in place **and** are gathered below. If they ever stop
   appearing, check that flag first.


How to add one
================

Put the directive in the page where the work belongs, and give it AIMS coordinates so it can
be sorted alongside the AA files::

   .. todo:: **AA-<area>-<slug>** (k4 Todo, s2 MidTerm):
      One sentence saying what needs doing and why, and any pointer needed to start.

Use a ``.. todo::`` for something small and local. Open an **AA file** instead when the task
needs a task list, a scope estimate, or a decision record --- see
``AHA/aa-anyaims-sorting.md`` for which is which.


The collected list
====================

.. todolist::


.. admonition:: Known duplication --- to be reconciled
   :class: warning

   Two older pages also carry a ``.. todolist::`` directive and therefore render **this same
   global list** a second and third time:

   - ``source/matheology/jub/anyaims.rst`` (line ~34)
   - ``source/matheology/pet/anyaims.rst`` (line ~77)

   ``todolist`` is **global** --- it always collects every ``.. todo::`` in the project and
   cannot be scoped to a subtree. So those pages do not show "the JUB todos" or "the PET
   todos"; they show all of them, under a heading implying otherwise.

   Recorded rather than fixed here, because ``pet/anyaims.rst`` also carries its own written
   AA entry (``AA-PET-EDEN-a1``, k7 s7) that must not be lost in any cleanup. Suggested
   resolution: keep the written entries in place, replace the two ``.. todolist::``
   directives with a link to this page. **Ask LLoL first.**


See also
==========

- :doc:`/_post/aa/index` --- the AA registry and the placement rule
- ``AHA/aa-anyaims-sorting.md`` --- which AA file lives where, and why