Skip to content

Instantly share code, notes, and snippets.

View sergeliatko's full-sized avatar
💭
Looking for talented PHP / JavaScript / WordPress developers. Apply now!

Serge Liatko sergeliatko

💭
Looking for talented PHP / JavaScript / WordPress developers. Apply now!
View GitHub Profile
@sergeliatko
sergeliatko / the-shape-of-a-mind.md
Last active July 15, 2026 15:04
The Shape of a Mind

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
sergeliatko / markdown.instructions.md
Created July 1, 2026 09:28
Markdown guidance for agents
applyTo **/*.md

Markdown Formatting Rules

The background

Four audiences read Markdown files in this repository:

@sergeliatko
sergeliatko / code-commenting-specification-v2.md
Created June 25, 2026 08:43
Code Commenting Specification

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
sergeliatko / architecture.schema.md
Created June 24, 2026 16:33
Architecture schema

Architecture Schema

Carrier Files

Schema version 3 uses semantic architecture carrier names:

architecture.yaml
architecture.unit.yaml
architecture.environment.yaml
@sergeliatko
sergeliatko / the-agent-as-runtime.md
Created June 24, 2026 12:23
The Agent as Runtime
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
sergeliatko / architechture-vision.md
Created June 20, 2026 13:36
Architecture as Units, Environments, and Contracts

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
sergeliatko / 01-raw-text.txt
Created January 16, 2025 14:28
Point of sale training manual
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
{
"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": [],
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.
FORM 10-Q
FORM 10-Q
Cover Page Information
(Mark One) Selection Option for Filing Type
Quarterly Report Pursuant to Section 13 or 15(d) of the Securities Exchange Act of 1934 for Period Ending June 30, 2019
Alternative Option for Transition Report Filing
Transition Report Pursuant to Section 13 or 15(d) of the Securities Exchange Act of 1934 ...
Commission File Number Identifier
Registrant's Exact Name as Specified in Charter
Jurisdiction and IRS Employer Identification Number