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.

sergeliatko

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

sergeliatko

FORM 10-K
	 FORM 10-K
	 Filing Information under the Securities Exchange Act of 1934
		 Annual and Transition Report Filing Information under the Securities Exchange Act of 1934.
	 DOCUMENTS INCORPORATED BY REFERENCE
		 Incorporation by Reference of Definitive Proxy Statement for 2020 Annual Meeting of Stockholders.
		 Exclusion of Proxy Statement from Form 10-K Filing.
	 TABLE OF CONTENTS
	 PART I Item 1 Business 1 Item 1A Risk Factors 10 Item 1B Unresolved Staff Comments 28 Item 2 Properties 28 Item 3 Legal Proceedings 28 Item 4 Mine Safety Disclosures 28
	 PART II Item 5 Market for Registrant’s Common Equity, Related Stockholder Matters and Issuer Purchases of Equity Securities 29 Item 6 Selected Consolidated Financial Data 31 Item 7 Management’s Discussion and Analysis of Financial Condition and Results of Operations 32 Item 7A Quantitative and Qualitative Disclosures About Market Risk 50 Item 8 Consolidated Financial Statements and Supplementary Data 52 Item 9 Changes in and Disagreements with Accountant