Files
knowledge-wiki/channels/1547923343905259601.md
T

11 KiB
Raw Blame History

Channel Wiki: #cogarch-v1-shorts

Channel ID: 1547923343905259601 Created: 2026-09-11 10:54 UTC Last sync: 2026-10-03 03:04 UTC Latest processed human message: 1555558619376918659

Purpose

Plan, create, review, and maintain concise short-form CogArch content. Specific formats, audiences, distribution channels, and publication targets remain to be decided in this channel.

Canonical Resources

  • Channel workspace: /opt/data/cogarch-v1-shorts/
  • Channel skill repository: https://gitea.lego-cloud.eu/cognitive-architect-v1-skills-code-agent/cogarch-v1-channel-shorts
  • Current verified deck: /opt/data/cogarch-v1-shorts/workspace/vscode-local-setup-4-working-with-skills/release/2026-09-22-ibm-cognitive-architect-shorts-vscode-local-setup-4-working-with-skills-1.0.1.pptx.
  • Current verified preview: /opt/data/cogarch-v1-shorts/workspace/vscode-local-setup-4-working-with-skills/release/2026-09-22-ibm-cognitive-architect-shorts-vscode-local-setup-4-working-with-skills-1.0.1-preview.png.
  • Architecture in an AI World current revised deck: /opt/data/cogarch-v1-shorts/workspace/architecture-in-an-ai-world/release/2026-09-25-cognitive-architect-session-01-architecture-in-an-ai-world-1.9.1.pptx (11 slides; SHA-256 f93c98dd4ef40871b547e5de950d3ceb47a70eb7dcfff9d01523c8c881e3845d).
  • Current individual slide previews: /opt/data/cogarch-v1-shorts/workspace/architecture-in-an-ai-world/preview/1.9.1/slide-01.png through slide-11.png.
  • Reproducible source is in /opt/data/cogarch-v1-shorts/workspace/architecture-in-an-ai-world/source/; v1.9.1 is built by build_session_01_v191.py.
  • Deck decision: former slides 3–5 were consolidated into one slide based on slide 4. The combined slide places six participant questions around one shared architecture model and incorporates the architecture content of purpose, structure, qualities, decisions, ownership, and traceability.
  • Deck decision: former slides 6–7 were consolidated into one slide based on slide 6. The combined slide preserves the Architect Curates / AI Accelerates split and adds a compact Encode → Act → Validate → Learn feedback loop.
  • Deck decision: three visual reference slides were added after the shared-model slide: FINOS CALM, Structurizr, and ArchiMate. Each carries a verified, clickable link to its official documentation; the deck duration changed to 15–20 minutes.
  • Opening-slide decision: address a top-tier architect audience with a substantive, debatable thesis rather than a basic orientation statement. Preserve design as a continuing hard problem; present AI as multiplying architectural decisions and the coherence burden, not replacing the design challenge. Do not mention cheaper code. Current thesis: “AI does not reduce the challenge of design. It multiplies the decisions architecture must keep coherent.”
  • Presentation preview decision (supersedes the earlier composite-preview rule): always return every slide as its own image attachment, in slide order. Do not combine slides into a single vertical image or thumbnail contact sheet, because combined previews are difficult to view. When the user changes or reinforces this preview approach, immediately return the latest presentation version as separate slide images; do not only acknowledge or record the preference.
  • Deck-content decision: remove “prompt enablement backbone” and “minutes” from the referenced deck location. The source message does not identify a slide number, so the exact target location remains UNKNOWN in this ledger rather than inferred.

Action Items

  • Verify the powerpoint-cognitive-architect remote repository/runtime installation separately; the current deck artifact is locally verified.

Key Decisions

  • The channel was assigned its own workspace, durable wiki, dedicated channel skill, and daily knowledge-sync coverage.
  • Maintain a CogArch-specific presentation skill named powerpoint-cognitive-architect under the Cognitive Architect skills organization. It must reference the general PowerPoint skills instead of duplicating or overlapping their capabilities.
  • The Shorts deck is a light, professional IBM presentation titled IBM | Cognitive Architect | Shorts (Solution Factory); it omits the date, identifies presenter Oleg Lukasonok (oleg.lukasonok@lt.ibm.com, Slack nickname lego), and presents the Cognitive Architect, Solution Factory tutorial, and cognitive-architect Slack channel as clearly labeled links.
  • The deck has three slides: title, Agenda, and links. The Agenda order is: “How to enable Solution Factory?”, “How to access Solution Factory?”, then “What is Solution Factory?”.
  • The VSCode Local Setup 4 Working With Skills short uses the agenda vscode-local-setup, skill-manager, and cognitive-architect; its second link is Documentation | Tutorial | Skills at https://pages.github.ibm.com/CTOTools/Documentation/docs/user-guide/services/agent-skills/.
  • Discord topic: Plan, create, review, and maintain concise short-form CogArch content.
  • Pinned channel guidance: message 1547924959656157256.
  • Mutable channel history belongs in this wiki, not in Hermes gateway configuration or the reusable channel skill.

Active Topics

  • Daily sync 2026-10-03 read messages 1555555247173140560 and 1555558619376918659: include the supplied prompts before the last slide, then remove the referenced content. The second message's text alone does not identify the target; the existing channel workflow below records it as “and the 32px grid.” Artifact validation below is historical channel-workflow evidence, not a fresh rebuild by this sync.

  • Architecture With Skills v1.2.1 removes “and the 32px grid” from the visible step 02 on the eShop prompts slide, per message 1555558619376918659. Step now reads “Use re-runnable diagram generators.” Original supplied prompts remain verbatim in notes. Deck: architecture-with-skills/release/2026-10-02-ibm-cognitive-architect-shorts-architecture-with-skills-1.2.1.pptx; separate previews under architecture-with-skills/preview/1.2.1/. Package and geometry checks passed.

  • Architecture With Skills v1.2.0 adds the supplied eShop prompt workflow immediately before Links (message 1555555247173140560). Four slides: Title, Agenda, eShop prompts, Links. Eight concise steps appear on slide 3; the complete supplied file, including later-change prompts, is preserved verbatim in slide 3 speaker notes and companion eshop-reference-architecture-prompts.txt. Deck: /opt/data/cogarch-v1-shorts/workspace/architecture-with-skills/release/2026-10-02-ibm-cognitive-architect-shorts-architecture-with-skills-1.2.0.pptx; previews: architecture-with-skills/preview/1.2.0/slide-01.png through slide-04.png. Package, slide-order, notes-equality and geometry checks passed. Previews are approximate; native rendering unavailable. The prompts were included as presentation content, not executed.

  • Architecture With Skills v1.1.0 supersedes the draft agenda below. RootAtSkic supplied the exact agenda and repository links (message 1555269400460787813): cognitive-architect, cognitive-architect-2-archify, cognitive-architect-2-calm-finos, cognitive-architect-2-structurizr, cognitive-architect-2-archimate, in that order. Each name links to https://github.ibm.com/CTOTools-skills-code-agent/<name>. Deck: /opt/data/cogarch-v1-shorts/workspace/architecture-with-skills/release/2026-10-01-ibm-cognitive-architect-shorts-architecture-with-skills-1.1.0.pptx; individual previews: architecture-with-skills/preview/1.1.0/slide-01.png through slide-03.png. Title and resource slides unchanged. Exact five hyperlink targets, order, three-slide count, package and geometry checks passed; repository reachability not claimed.

  • New topic requested: Architecture With Skills (message 1555257919635853365). Draft v1.0.0 follows the preceding three-slide Shorts format: title, proposed agenda, existing resource links. Draft agenda (assistant-proposed, not yet approved): What are AI agent skills?; How to apply skills in architecture work?; How to validate and refine the results?. File: /opt/data/cogarch-v1-shorts/workspace/architecture-with-skills/release/2026-10-01-ibm-cognitive-architect-shorts-architecture-with-skills-1.0.0.pptx. Separate approximate previews are under architecture-with-skills/preview/1.0.0/; native PowerPoint/LibreOffice rendering is unavailable. Package, XML, content, slide-count and geometry checks passed.

  • RootAtSkic set aside the latest Architecture in an AI World presentation and returned to the preceding three-slide Shorts deck (message 1555257448691011585). The latest preceding deck is VSCode Local Setup 4 Working With Skills v1.0.1; the AI presentation remains preserved, not deleted.

  • Define the initial short-form content format, audience, editorial style, and publication destination.

Key Context

  • CogArch architecture-format work follows the cogarch-v1 skill and accepted project decisions.
  • No publication destination or permission is implied by channel setup.

People & Roles

  • RootAtSkic (1518725627845283888) — channel owner and human authority.
  • Hermes (1526860732917088266) — assisting bot.

Action Items

  • Decide the first short's subject, audience, format, and publication target.

Evidence

  • 1547923376725565491 — RootAtSkic requested: “Set up this channel.”
  • 1552630471056302161 — RootAtSkic started the Architecture in an AI World short from the enablement-channel presentation.
  • 1552631460748468336, 1552644274615619595 — earlier full-deck preview approach used a numbered vertical composite; this was later superseded.
  • 1552947379068731483 — RootAtSkic changed the preview rule: always return one separate image per slide because a single combined image is difficult to view.
  • 1552948492727619615 — RootAtSkic clarified that this rule requires immediately returning the latest presentation-version slide images, not merely recording the preference.
  • 1552949611071537164 — RootAtSkic rejected the opening slide’s cheap-code-centered statement and directed the session framing toward preparing architecture for an AI world; cheaper code is only one circumstance within the broader change.
  • 1552955903546892342 — RootAtSkic clarified that cheaper code should not appear on the opening slide at all.
  • 1552960206533562389 — RootAtSkic rejected the elementary “Preparing architecture for an AI world” line and required an opening worthy of top architects rather than language that talks down to them.
  • 1552961770610622485 — RootAtSkic rejected wording that implied the design challenge disappears; the opening must preserve design as difficult while explaining the additional AI-era coherence burden.
  • 1552962884965761069 — RootAtSkic directed: “Drop prompt enablement backbone and minutes from there”; exact slide/location was not stated in the message.
  • 1552645349875777558, 1552647879347142710, 1552657484303568927 — consolidate former slides 3–5 using slide 4 as the basis and former slides 6–7 using slide 6 as the basis.
  • 1552659377788420109, 1552659408217968721 — include one linked documentation slide each for FINOS CALM, Structurizr, and ArchiMate.