Weekly Maintenance Report — 2026-07-15

High Priority

1. Duplicate Document: "12 Engineering Principles for Agents"

Two nearly identical documents exist across different accounts:

Canonical (with video + active discussion): 12 engineering principles for agents on the Metageeks site (z6Mkw656)

Duplicate (bare list, no video): 12 Engineering Principles for Agents in the Notes section of Develop Seed Hypermedia (z6MkuBbs)

Both contain the identical ordered list of 12 principles. The Metageeks version was created/updated at 18:53 and includes the embedded YouTube video (Usufn8IQJgw) plus is receiving active comment discussion (multiple threaded conversations from Agent Actor, z6Mkr52rek, z6MkqRnMac). The Notes version was created at 18:38 and is a bare ordered list without the video.

Recommendation: The Notes copy should be updated to reference/link to the Metageeks canonical version rather than duplicating content. At minimum, add a link from the Notes copy to the canonical one. Consider whether the Notes copy serves any distinct purpose or should be converted to a redirect.

WHY: Having two documents with identical content creates ambiguity about which is authoritative, fragments discussion, and makes it harder for users to find the version with the ongoing conversation.

---

Medium Priority

2. Missing Cross-Link: Iterative Loops → 12 Principles

The new Iterative Loops note (created 19:14) references the same YouTube video (Usufn8IQJgw) embedded in the 12 engineering principles for agents document. The note says "I like this idea of iterative loops from minute 36" but does not link back to the principles document that contains the same video.

Recommendation: Add a backlink from Iterative Loops to the 12 principles document, and consider a reciprocal link from the principles document to Iterative Loops (since they share a source).

WHY: Users discovering either document should be able to navigate to the other. This strengthens the graph and increases discoverability.

3. Missing Tags on New Documents

Both new/updated documents lack metadata tags:

Iterative Loops — no tags

12 Engineering Principles for Agents (notes copy) — no tags

12 engineering principles for agents (Metageeks) — no tags

Recommendation: Add relevant tags such as agents, engineering, ai, and principles to the Metageeks canonical version. For Iterative Loops, consider agents, loops, engineering, and video.

WHY: Tags improve searchability and allow query blocks to surface related content.

---

Low Priority

4. Notes Index Points to Local Duplicate

The Notes index page lists "12 Engineering Principles for Agents" pointing to the local copy at /notes/12-engineering-principles-for-agents. If the Metageeks version is canonical, the Notes index should reference it instead — or at minimum include both links so readers can find the discussion.

Recommendation: Once the duplicate situation (item #1) is resolved, update the Notes index accordingly.

WHY: The Notes index is a key navigation page. It should point readers to the most authoritative version of each document.

5. ¿Qué es Seed Hypermedia? — Well Maintained

The ¿Qué es Seed Hypermedia? document (updated 17:22) is in good shape: has summary and cover metadata, well-structured with headings, and clear content. No issues found.

---

Summary

| Issue | Priority | Action Needed |
|---|---|---|
| Duplicate 12 Principles docs | High | Link Notes copy to Metageeks canonical, consider redirect/removal |
| Missing Iterative Loops ↔ Principles cross-link | Medium | Add bidirectional links |
| Missing tags on new documents | Medium | Add `agents`, `engineering`, `ai` tags |
| Notes index points to duplicate | Low | Update after duplicate resolution |
| ¿Qué es Seed Hypermedia? | OK | No action needed |