Skip to content

docs: add 'The Seven Spheres of Human-AI Co-Development' to docs/#1100

Merged
amrmelsayed merged 5 commits into
mainfrom
builder/air-1099
Jun 24, 2026
Merged

docs: add 'The Seven Spheres of Human-AI Co-Development' to docs/#1100
amrmelsayed merged 5 commits into
mainfrom
builder/air-1099

Conversation

@amrmelsayed

Copy link
Copy Markdown
Collaborator

Summary

Adds The Seven Spheres of Human-AI Co-Development by Waleed Kadous to the in-repo docs/ tree so the article is discoverable alongside docs/faq.md, docs/tips.md, docs/why.md and survives independently of the cluesmith.com blog.

Closes #1099.

Changes

  • docs/seven-spheres.md — the article body, plain markdown, verbatim from the authoritative copy in the issue (no rewording, no editorialising). Attribution block (author Waleed Kadous, date 2026-02-10, source URL https://cluesmith.com/blog/seven-spheres) sits directly under the H1, before the cover image. The acknowledgements paragraph and the AI-collaboration footnote are preserved verbatim at the end. No YAML frontmatter, matching the sibling docs.
  • docs/assets/seven-spheres-cover.png — the cover image, fetched once from https://cluesmith.com/images/blog/seven-spheres/cover.png and committed as a binary (valid PNG, 2004×1536 RGBA, ~2.8 MB). The article references it as a relative path ./assets/seven-spheres-cover.png, which resolves correctly when viewed on GitHub from docs/.
  • codev/state/air-1099_thread.md — builder thread (cohort situational awareness).

Key decisions

All locked in the issue's plan-gate / baked-decisions section; no autonomous design choices were made:

  1. Flat location docs/seven-spheres.md (no docs/blog/ or docs/articles/ subdir for a single article).
  2. Image filename docs/assets/seven-spheres-cover.png (kebab-case, scoped suffix).
  3. Attribution-first placement directly under the H1.
  4. No frontmatter (matches faq.md/tips.md/why.md).
  5. No cross-linking from other docs / README (out of scope; separate issue if wanted).

Test plan

No tests added — this is pure markdown + a binary image; there is nothing to assert and no CI/runtime behavior changes. Validation performed:

  • npm run build → passes (exit 0).
  • Unit tests (npm test, e2e excluded) → pass.
  • Image verified as a valid PNG via file; relative image path checked against the docs/ location.

Out of scope

Cross-linking from README/other docs, restructuring docs/ into a docs/articles/ subdir, republishing elsewhere, and image optimisation — all deferred per the issue.

Add docs/seven-spheres.md (article body verbatim from the source, with
attribution block and AI-collaboration footnote preserved) plus the cover
image at docs/assets/seven-spheres-cover.png so the article is discoverable
in-repo and survives independently of the cluesmith.com blog.

Closes #1099
Put author and publication date on separate lines (markdown hard breaks);
render the cover via <img width="640"> to constrain its display width.
@amrmelsayed amrmelsayed merged commit 6d3908e into main Jun 24, 2026
6 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

docs: add 'The Seven Spheres of Human-AI Co-Development' to docs/

1 participant