Skip to content

Rewrite DevX growth essay and preserve old URL - #66

Merged
ryanbaumann merged 7 commits into
mainfrom
agent/devx-growth-discipline
Jul 15, 2026
Merged

Rewrite DevX growth essay and preserve old URL#66
ryanbaumann merged 7 commits into
mainfrom
agent/devx-growth-discipline

Conversation

@ryanbaumann

Copy link
Copy Markdown
Owner

What changed

  • Renames the canonical essay route from devex to devx and preserves the old route with an HTTP 308 redirect.
  • Adds reusable front-matter aliases and a generated redirect manifest for future detail-page renames.
  • Rewrites the essay around owning friction, shipping product improvements, distribution, and measurable outcomes with agent evals.
  • Replaces the text-heavy portrait hero with a 16:9 loop diagram, adds a dedicated 1200x627 PNG social card, and embeds a real agentic-evals artifact in the article.

Why

The original essay had the wrong DevX spelling in its URL, generic copy, and an oversized infographic that repeated the title instead of advancing the argument. URL changes also lacked a durable redirect mechanism.

Verification

  • cd portfolio && npm test (18 tests passed; production build passed)
  • cd gateway && npm test (80 tests passed)
  • node scripts/build-local.mjs && node scripts/smoke.mjs (17 smoke checks passed)
  • Browser screenshots at 1440x1000 and 390x844
  • Manual HTTP check: old URL returns 308 with query string preserved; new URL returns 200

@ryanbaumann

Copy link
Copy Markdown
Owner Author

Review-loop update:

  • Installed and reloaded Infographic Agent 3.2.0 (gemini-3.5-flash research, opt-in gemini-3.1-flash-image quality renderer).
  • Completed three independent review passes for copy and redirect correctness. Final copy and redirect reviews are clean.
  • Tightened the essay with linked Voice of Developer, Code Assist, Agent Skills, and agentic-eval evidence.
  • Hardened aliases for slashless URLs, canonical collisions, private auth, writer builds, stale canonicals, external entries, and bodyless entries.
  • Added the three-asset standard to the content skill, writing template, and new-post guidance.

Verification:

  • Portfolio: 21 tests passed and production build passed.
  • Gateway: 80 tests passed.
  • Full staged build and smoke: 17 passed, 0 failed.

Visual replacement remains blocked: the Infographic Agent reached API-key onboarding because neither GEMINI_API_KEY nor a Vertex project is configured in this environment. The current assets remain temporary placeholders; the visual reviewer recommends replacing them rather than polishing them.

@ryanbaumann

Copy link
Copy Markdown
Owner Author

Final visual pass pushed.

  • Replaced the placeholder hero with a 1200×675 DevX operating-loop image.
  • Added a distinct 1200×627 social image and a 1200×675 inline agent-evaluation explainer.
  • Generated final sources with gemini-3.1-flash-image at 1K and high thinking after lite-model iteration.
  • Archived exact prompts and post-processing steps in docs/devx-essay-visual-prompts.json.
  • Added deterministic social-card reproduction from the uncropped source.
  • Verified desktop and mobile captures, true PNG formats, portfolio tests/build, gateway tests, full local build, and smoke suite.

Local review remains available at http://127.0.0.1:4173/writing/devx-is-a-growth-discipline/ .

@ryanbaumann

Copy link
Copy Markdown
Owner Author

Added durable portfolio review policy in commit f6c453c.

  • New .agents/skills/portfolio-review workflow for copy, claims, links, canonicals, redirects, images, metadata, accessibility, and desktop/mobile rendering.
  • Mandatory maker/checker review with independent lanes and a three-round stop rule.
  • Deterministic verification before and after correction passes.
  • Portfolio writing, design, and content skills now route through the review gate.
  • Updated AGENTS.md, CHANGELOG.md, and LEARNINGS.md.

Verification: portfolio tests 21/21 and build passed; skill metadata validated with an available local check because the upstream validator lacks PyYAML in this environment. The workflow was independently forward-tested and produced a valid terminal verdict. All GitHub checks are green.

@ryanbaumann
ryanbaumann marked this pull request as ready for review July 15, 2026 19:55
@ryanbaumann
ryanbaumann merged commit 214042d into main Jul 15, 2026
8 checks passed
@ryanbaumann
ryanbaumann deleted the agent/devx-growth-discipline branch July 15, 2026 19:56
@ryanbaumann

Copy link
Copy Markdown
Owner Author

Upstream compatibility fix opened as draft: ryanbaumann/infographic-agent#9. It prepares infographic-agent@3.2.1 and reconciles Python 3.9 / google-genai 1.47.0 without losing high-thinking and explicit-resolution behavior on newer SDKs. After #9 merges and publishes, refresh the vendored skill in this PR so skills-lock.json matches the released upstream package before merging Portfolio #66.

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.

1 participant