sergeliatko

Software Architecting Agent Surface Intake: Superpowers Comparative Analysis

Document Control

Field	Value
Purpose	Compare the locally cached OpenAI-curated Superpowers package with the architecture, planning, testing, writing, coordination, and feedback practices being developed for this repository and the wider portfolio.
Authority	Evidence and analysis only. This report does not change SFS-001, accept an architecture decision, modify a skill, or authorize implementation.
Evidence date	2026-07-24
Repository scope	saas-framework, with read-only evidence from named sibling repositories and installed skill snapshots.

sergeliatko

The Shape of a Mind

A working proposal for mapping information-handling capacity

Status: Open paper, presented for discussion. This is not a finished theory. The claim is narrower: there may be a useful structure here, precise enough to develop and test.

Abstract

A system can preserve the sound of a sentence without preserving a statement. It can produce a correct answer without operating on the concepts expressed by that answer. It can distinguish patterns without treating them as symbols. These differences are difficult to describe with a single term such as intelligence or a single score intended to measure it.

sergeliatko

applyTo	**/*.md

Markdown Formatting Rules

The background

Four audiences read Markdown files in this repository:

sergeliatko

Code Commenting Specification

Version 2.0.0

A specification for code commenting in multi-entity codebases where humans, AI agents, and automated tools collaborate.

1. Abstract

This specification defines principles, a tag vocabulary, requirement levels, and guidelines for code comments in software projects. It treats code comments as a form of cross-intelligence context transfer: persistent, asynchronous messages embedded in source code that carry information not available from the code itself.

sergeliatko

Architecture Schema

Carrier Files

Schema version 3 uses semantic architecture carrier names:

architecture.yaml
architecture.unit.yaml
architecture.environment.yaml

sergeliatko

title	The Agent as Runtime
subtitle	A pattern for stateless, multi-step workflow orchestration on MCP
status	Architecture pattern (proposal for discussion)
version	1.0
date	2026-06-24

The Agent as Runtime

sergeliatko

Architecture as Units, Environments, and Contracts

Purpose

Software architecture is written down in pieces today, scattered across diagrams, decision records, naming conventions, folder layouts, and people's memory. Each discipline keeps its own fragment, and the fragments do not line up, so the architecture rots quietly while the code keeps moving.

This document proposes one way to describe architecture that holds at every level, so the pieces stop drifting apart. It gives a small set of primitives and some guidance. Everything operational is left to you.

The whole thing in two smells

sergeliatko

src: https://betechnamibia.com/Point%20of%20Sale%20-%20Training%20Manual.pdf

1 | P a g e
Point of Sale
TRAINING MANUAL
VERSION : 1:4:1536
2 | P a g e
4 | P a g e
The POS Screen
 The POS screen is the first screen the users will see when the

sergeliatko

{
  "questions": [
    {
      "contractId": "aaa-123456789",
      "checkpoint": {
        "checkpointId": "123456789-1",
        "type": "question",
        "question": "What is the current cash position (including the sum of 'Cash and cash equivalents', 'Marketable securities', and 'Short-term investments')?",
        "answers": [],
        "examples": [],

sergeliatko

FORM 10-Q
     FORM 10-Q
     Cover Page Information
         (Mark One) Selection Indicator
             [X] Quarterly Report Pursuant to Section 13 or 15(d) of the Securities Exchange Act of 1934 for Period Ending September 30, 2020
         Transition Report Option Selection
             Transition Report Pursuant to Section 13 or 15(d) of the Securities Exchange Act of 1934
         Registrant Information: ConocoPhillips Details including Commission File Number, State of Incorporation, IRS Employer Identification Number, Principal Executive Office Address, and Telephone Number
         Securities Registered under Section 12(b) of the Securities Exchange Act of 1934 :
         Filing Compliance with Sections 13 and 15(d) of the Securities Exchange Act of 1934.