try-professional 0.1.0__py3-none-any.whl

try_professional/__init__.py

@@ -0,0 +1,3 @@
+"""Try Professional: a structured company of LLM agents."""
+
+__version__ = "0.1.0"

try_professional/_playbooks/ceo.md

@@ -0,0 +1,38 @@
+---
+playbook: ceo
+version: 2
+---
+
+# CEO playbook
+
+How the root role runs every command, for any business. Only the current step's section reaches the model, so each one stays short.
+
+## intake
+
+Understand the command first.
+1. Keep original_goal exactly as written. Restate it in one sentence. Record its language as user_language (a BCP 47 tag).
+2. Record constraints, and success criteria someone could check. Don't invent requirements.
+3. Set size. small: one department and one or two roles can do it. large: anything more. When unsure, choose large.
+4. If small, set route_department, and route_role if one role can do it alone, exactly as listed below.
+Review happens automatically at either size.
+
+## plan
+
+Use the fewest work packages that meet the command: one is often right.
+1. Activate only the departments it needs, with a reason for each.
+2. Give each package one owning department, checkable acceptance criteria, and its dependencies.
+3. Set token_budget: about 15000 for simple work, 40000 for hard work, within the run's limit.
+4. If it asks for a document or a plan, the work is to write it, not to build what it describes.
+Don't plan review steps: QA and legal review happens automatically.
+
+## escalation
+
+An item was escalated to you. Resume it with clear guidance, amend the plan, or abandon it. If it needs something this company can't reach, such as the web, don't wait for that: resume it, and have the work done without it, with those claims marked unverified for a person to check. Ask the person only if the decision is truly theirs, or no useful version of the work exists.
+
+## integrate
+
+Assemble one deliverable from the approved work. Report on every success criterion, using its exact wording, with evidence. Say plainly what wasn't done. Write summary_in_user_language in the user's language, for someone who didn't see the work.
+
+## retrospective
+
+Propose what the whole company should remember: rules, major decisions, and lessons across departments. A person approves each one, so propose few, and be specific. Leave out what only one team needs.

try_professional/_playbooks/manager.md

@@ -0,0 +1,27 @@
+---
+playbook: manager
+version: 3
+---
+
+# Manager playbook
+
+How a department head runs a work package, for any business. A head doing a task personally follows the staff playbook for it.
+
+## dispatch
+
+Break this package into tasks a junior could do from the brief alone. Use the fewest: one is often right.
+1. Keep each task to one output and a few steps.
+2. Assign by the best fit of mission and skills, then by fewest open tasks. owner_role and output_type must come exactly from the list below.
+3. Write the brief: goal, context, inputs, expected_output, a checkable definition_of_done, and only the memory and skills that bear on it.
+4. Mark dependencies. Independent tasks may run in parallel.
+5. Decide any team lessons listed below: adopt_lessons or drop_lessons.
+Don't add work that wasn't asked for, or review tasks: review is automatic.
+
+## review
+
+Review the artifact against its definition of done and the goal. Don't rely on its evidence. Check it yourself: redo every sum, compare each fact with the brief, read all of it for language, and count any limit.
+A claim of fact that the brief doesn't support and no source backs is at least major, however small or plausible. Major and blocker issues mean you send it back. Approve only what you checked. Say what's wrong, where, and what done looks like.
+
+## escalation
+
+A report escalated this. Resume it with specific guidance if you can. If it needs something this company can't reach, such as the web, have the work done without it, with those claims marked unverified for a person to check. Otherwise escalate further, and say what you tried.

try_professional/_playbooks/memory-and-skills.md

@@ -0,0 +1,20 @@
+---
+playbook: memory-and-skills
+version: 1
+---
+
+# Memory and skill policy
+
+What each level retrieves, and when. Code enforces the limits: a brief has a token budget, a task's memory is a few top hits from each tier, and a whole memory bank never reaches a prompt.
+
+## ceo
+
+Recall memory only for a specific question.
+
+## manager
+
+Recall memory only for a specific question.
+
+## staff
+
+Recall memory only for a specific question. memory_write is private to you: save only what you'd want next time.

try_professional/_playbooks/staff.md

@@ -0,0 +1,26 @@
+---
+playbook: staff
+version: 3
+---
+
+# Staff playbook
+
+How any role does and reviews a task, for any business.
+
+## execute
+
+Do this task and submit the result.
+1. Your brief's goal, expected output and definition of done are the job. Don't add work.
+2. If a listed skill fits, read it first.
+3. Report every item of the definition of done in done_criteria_met, word for word, with evidence. Never claim what you didn't check.
+4. In notes, record what you did, any decision or promise, and a lesson for next time. Put a lesson for your whole team in team_lesson.
+If something is missing, do what you can, and mark the rest unverified with what a person must check. Call escalate only if nothing useful can be done, and say what's missing.
+
+## review
+
+Review the artifact against its definition of done and the goal. Don't rely on its evidence. Check it yourself: redo every sum, compare each fact with the brief, read all of it for language, and count any limit.
+A claim of fact that the brief doesn't support and no source backs is at least major, however small or plausible. Major and blocker issues mean you send it back. Approve only what you checked. Say exactly what's wrong.
+
+## escalation
+
+An item was escalated to you. Decide how to resolve it, or escalate it further.

try_professional/_spec/__init__.py

@@ -0,0 +1 @@
+"""Packaged copies of the canonical schemas in spec/. A test keeps them identical."""

try_professional/_spec/org-v1.schema.json

@@ -0,0 +1,278 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://raw.githubusercontent.com/goranai/try-professional/main/spec/org-v1.schema.json",
+  "title": "Organization definition, spec org/v1",
+  "type": "object",
+  "required": [
+    "spec",
+    "company",
+    "root_role",
+    "departments"
+  ],
+  "additionalProperties": false,
+  "patternProperties": {
+    "^x-": {}
+  },
+  "properties": {
+    "spec": {
+      "const": "org/v1"
+    },
+    "company": {
+      "type": "object",
+      "required": [
+        "name"
+      ],
+      "additionalProperties": false,
+      "patternProperties": {
+        "^x-": {}
+      },
+      "properties": {
+        "name": {
+          "type": "string",
+          "minLength": 1
+        },
+        "description": {
+          "type": "string"
+        },
+        "business": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "industry": {
+              "type": "string"
+            },
+            "products": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            },
+            "channels": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            }
+          }
+        }
+      }
+    },
+    "root_role": {
+      "$ref": "#/$defs/role_ref"
+    },
+    "departments": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "$ref": "#/$defs/department"
+      }
+    },
+    "gates": {
+      "type": "object",
+      "additionalProperties": false,
+      "patternProperties": {
+        "^x-": {},
+        "^[a-z][a-z0-9-]*$": {
+          "$ref": "#/$defs/gate"
+        }
+      }
+    },
+    "pipeline": {
+      "$ref": "#/$defs/pipeline"
+    },
+    "llm_overrides": {
+      "description": "Per-department or per-role model settings. A role's fields win over its department's.",
+      "type": "object",
+      "additionalProperties": false,
+      "patternProperties": {
+        "^x-": {},
+        "^[a-z][a-z0-9-]*(/[a-z][a-z0-9-]*)?$": {
+          "$ref": "#/$defs/llm_override"
+        }
+      }
+    }
+  },
+  "$defs": {
+    "id": {
+      "type": "string",
+      "pattern": "^[a-z][a-z0-9-]*$"
+    },
+    "role_ref": {
+      "type": "string",
+      "pattern": "^[a-z][a-z0-9-]*/[a-z][a-z0-9-]*$"
+    },
+    "local_or_full_ref": {
+      "type": "string",
+      "pattern": "^[a-z][a-z0-9-]*(/[a-z][a-z0-9-]*)?$"
+    },
+    "flag": {
+      "enum": [
+        "public_facing",
+        "touches_license",
+        "touches_personal_data"
+      ]
+    },
+    "department": {
+      "type": "object",
+      "required": [
+        "id",
+        "head",
+        "roles"
+      ],
+      "additionalProperties": false,
+      "patternProperties": {
+        "^x-": {}
+      },
+      "properties": {
+        "id": {
+          "$ref": "#/$defs/id"
+        },
+        "name": {
+          "type": "string",
+          "minLength": 1
+        },
+        "head": {
+          "$ref": "#/$defs/id"
+        },
+        "activation": {
+          "enum": [
+            "always",
+            "on_demand"
+          ],
+          "default": "on_demand"
+        },
+        "qa_gate": {
+          "type": "object",
+          "required": [
+            "reviewer"
+          ],
+          "additionalProperties": false,
+          "properties": {
+            "reviewer": {
+              "$ref": "#/$defs/local_or_full_ref"
+            }
+          }
+        },
+        "roles": {
+          "type": "array",
+          "minItems": 1,
+          "items": {
+            "$ref": "#/$defs/id"
+          }
+        }
+      }
+    },
+    "gate": {
+      "type": "object",
+      "required": [
+        "reviewer",
+        "triggers"
+      ],
+      "additionalProperties": false,
+      "patternProperties": {
+        "^x-": {}
+      },
+      "properties": {
+        "reviewer": {
+          "$ref": "#/$defs/role_ref"
+        },
+        "triggers": {
+          "type": "array",
+          "minItems": 1,
+          "items": {
+            "$ref": "#/$defs/flag"
+          }
+        },
+        "on_unavailable": {
+          "enum": [
+            "block",
+            "waive"
+          ],
+          "default": "block"
+        }
+      }
+    },
+    "pipeline": {
+      "type": "object",
+      "additionalProperties": false,
+      "patternProperties": {
+        "^x-": {}
+      },
+      "properties": {
+        "max_parallel_tasks": {
+          "type": "integer",
+          "minimum": 1,
+          "default": 4
+        },
+        "max_rework": {
+          "type": "integer",
+          "minimum": 0,
+          "default": 2
+        },
+        "max_invalid_outputs": {
+          "type": "integer",
+          "minimum": 0,
+          "default": 2
+        },
+        "working_language": {
+          "type": "string",
+          "minLength": 1,
+          "default": "auto"
+        },
+        "budget": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "max_tokens_per_small_command": {
+              "type": "integer",
+              "minimum": 1
+            },
+            "max_tokens_per_run": {
+              "type": [
+                "integer",
+                "null"
+              ],
+              "minimum": 1,
+              "default": null
+            },
+            "on_exceeded": {
+              "enum": [
+                "escalate"
+              ],
+              "default": "escalate"
+            }
+          }
+        }
+      }
+    },
+    "llm_override": {
+      "type": "object",
+      "minProperties": 1,
+      "additionalProperties": false,
+      "dependentRequired": {
+        "base_url": [
+          "api_key_env"
+        ]
+      },
+      "properties": {
+        "base_url": {
+          "type": "string",
+          "description": "Must be https, or http on this machine. Requires api_key_env, so a default key can't be sent to a new endpoint.",
+          "pattern": "^(https://[^\\s]+|http://(localhost|127\\.0\\.0\\.1)(:[0-9]+)?(/[^\\s]*)?)$"
+        },
+        "model": {
+          "type": "string",
+          "minLength": 1
+        },
+        "api_key_env": {
+          "description": "The NAME of an environment variable, never the key itself. null means no key.",
+          "type": [
+            "string",
+            "null"
+          ],
+          "pattern": "^[A-Z][A-Z0-9_]*$"
+        }
+      }
+    }
+  }
+}

try_professional/_spec/role-v1.schema.json

@@ -0,0 +1,122 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://raw.githubusercontent.com/goranai/try-professional/main/spec/role-v1.schema.json",
+  "title": "Role definition, spec role/v1",
+  "type": "object",
+  "required": [
+    "spec",
+    "id",
+    "department",
+    "mission",
+    "responsibilities",
+    "inputs",
+    "outputs",
+    "allowed_tools",
+    "allowed_skill_categories",
+    "escalation",
+    "reviewer",
+    "system_prompt"
+  ],
+  "additionalProperties": false,
+  "patternProperties": {
+    "^x-": {}
+  },
+  "properties": {
+    "spec": {
+      "const": "role/v1"
+    },
+    "id": {
+      "$ref": "#/$defs/id"
+    },
+    "title": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 60,
+      "description": "What people call this role, such as CTO. Changes no permission."
+    },
+    "department": {
+      "$ref": "#/$defs/id"
+    },
+    "mission": {
+      "type": "string",
+      "minLength": 1
+    },
+    "responsibilities": {
+      "$ref": "#/$defs/strings"
+    },
+    "inputs": {
+      "$ref": "#/$defs/strings"
+    },
+    "outputs": {
+      "$ref": "#/$defs/strings"
+    },
+    "allowed_tools": {
+      "$ref": "#/$defs/strings"
+    },
+    "allowed_skill_categories": {
+      "$ref": "#/$defs/strings"
+    },
+    "escalation": {
+      "description": "A role reference, or the literal 'human' for the root role only.",
+      "oneOf": [
+        {
+          "$ref": "#/$defs/role_ref"
+        },
+        {
+          "const": "human"
+        }
+      ]
+    },
+    "reviewer": {
+      "$ref": "#/$defs/role_ref"
+    },
+    "model_tier": {
+      "enum": [
+        "executive",
+        "standard",
+        "fast"
+      ],
+      "default": "standard"
+    },
+    "system_prompt": {
+      "type": "string",
+      "minLength": 1
+    },
+    "skill_needs": {
+      "description": "Short descriptions of the capabilities this role's skills should provide.",
+      "$ref": "#/$defs/strings"
+    },
+    "required_tools": {
+      "description": "Tools this role can't work without. Must be a subset of allowed_tools.",
+      "$ref": "#/$defs/strings"
+    },
+    "forbidden_tools": {
+      "description": "A skill that needs any of these is never matched to this role.",
+      "$ref": "#/$defs/strings"
+    },
+    "max_skills": {
+      "description": "Most skills this role's loadout may hold.",
+      "type": "integer",
+      "minimum": 1,
+      "maximum": 50,
+      "default": 8
+    }
+  },
+  "$defs": {
+    "id": {
+      "type": "string",
+      "pattern": "^[a-z][a-z0-9-]*$"
+    },
+    "role_ref": {
+      "type": "string",
+      "pattern": "^[a-z][a-z0-9-]*/[a-z][a-z0-9-]*$"
+    },
+    "strings": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "minLength": 1
+      }
+    }
+  }
+}

try_professional/_templates/README.md

@@ -0,0 +1,31 @@
+# Industry templates
+
+A template is where `trypro init "<business>"` starts. The Org Architect picks the closest one and adapts it. **Adding an industry is a good first contribution.**
+
+## Add one
+
+Create `templates/<your-id>/template.yaml`. Copy `youtube-shorts-studio` and change it. Then run:
+
+```bash
+python scripts/generate_schemas.py    # copies it into the package
+pytest packages/try-professional/tests/test_generator.py -k "Templates"
+```
+
+A test compiles every template, checks it against the spec and company policy, and runs a whole company through it with no model.
+
+## What goes in it
+
+| Field | What it's for |
+|---|---|
+| `id`, `name`, `description` | What it is |
+| `examples` | Businesses it suits. Used to choose a template locally, so add a few, including in other languages |
+| `departments` | The departments doing the work, each with one role of `kind: head` |
+
+**Leave out Executive, Legal, and QA.** Every company gets them. You also can't set tools, gates, budgets, escalation, or model settings: a role's `kind` decides its tools, and a template can't express the rest. That keeps templates safe to accept from anyone.
+
+## Writing good roles
+
+- **Keep it small.** Every role adds tokens on every run. Prefer 10 to 15 roles of your own.
+- **`skill_needs` find skills.** Use short, concrete, English phrases, such as `write a video hook`. Vague ones find nothing.
+- **Say what a role can't do.** The company produces files in v0.1. An editor writes edit notes, and doesn't edit video. It has no live data unless a person provides a file.
+- **Outputs:** `PublicContent`, `ResearchReport`, `TaskReport`, or `CodeChange`. Roles that output `ResearchReport` follow the rule on current claims, and can use web search if it's on.

try_professional/_templates/ecommerce-store/template.yaml

@@ -0,0 +1,114 @@
+# Executive, Legal, and QA are added to every company, so they aren't listed.
+id: ecommerce-store
+name: E-commerce store
+description: An online store that sources products, writes listings, markets them, and looks after customers.
+examples:
+  - an online store selling handmade goods
+  - a dropshipping business
+  - a marketplace seller on Shopee or Amazon
+  - toko online yang menjual produk rumahan
+departments:
+  - id: merchandising
+    name: Merchandising
+    roles:
+      - id: merchandising-lead
+        name: Head of Merchandising
+        kind: head
+        mission: Decide what the store sells, and how it's presented.
+        responsibilities:
+          - Choose products from research
+          - Review product listings
+        skill_needs:
+          - plan a product assortment
+          - review product listings
+        skill_categories: [strategy, ecommerce]
+        outputs: [TaskReport]
+        instructions: Say what evidence supports a product choice. Price and margin figures must come from files a person provides.
+      - id: product-researcher
+        name: Product Researcher
+        kind: worker
+        mission: Find out what shoppers want, and what competitors offer.
+        responsibilities:
+          - Research products and competitors
+          - Record a source and date for each claim
+        skill_needs:
+          - research products and market demand
+          - compare competitor products
+        skill_categories: [research, ecommerce]
+        outputs: [ResearchReport]
+        instructions: Report what sources say. Label anything without a source as unverified.
+      - id: listing-writer
+        name: Listing Writer
+        kind: worker
+        mission: Write product listings that are accurate and easy to buy from.
+        responsibilities:
+          - Write titles, descriptions, and specifications
+          - Flag any claim that needs proof
+        skill_needs:
+          - write product descriptions
+          - write marketplace listings
+        skill_categories: [copywriting, ecommerce]
+        outputs: [PublicContent]
+        instructions: Describe only what the product really is. Never invent materials, certifications, or reviews.
+  - id: marketing
+    name: Marketing
+    roles:
+      - id: marketing-lead
+        name: CMO
+        kind: head
+        mission: Bring in shoppers without misleading them.
+        responsibilities:
+          - Plan campaigns and promotions
+          - Review public content
+        skill_needs:
+          - plan marketing campaigns
+          - plan seasonal promotions
+        skill_categories: [marketing, strategy]
+        outputs: [TaskReport, PublicContent]
+        instructions: Every public claim needs a source. Discounts and deadlines must be real.
+      - id: campaign-writer
+        name: Campaign Writer
+        kind: worker
+        mission: Write email, social, and ad copy.
+        responsibilities:
+          - Write campaign copy for each channel
+          - List a source for each factual claim
+        skill_needs:
+          - write email marketing campaigns
+          - write social media posts
+          - write ad copy
+        skill_categories: [copywriting, social-media]
+        outputs: [PublicContent]
+        instructions: Write in the shopper's language. This company doesn't send or post anything. A person does.
+  - id: customer-care
+    name: Customer Care
+    roles:
+      - id: care-lead
+        name: Head of Customer Care
+        kind: head
+        mission: Make sure shoppers get clear answers and fair treatment.
+        responsibilities:
+          - Write support replies and policies
+          - Report recurring complaints
+        skill_needs:
+          - write customer support replies
+          - write return and refund policies
+        skill_categories: [support, documentation]
+        outputs: [TaskReport, PublicContent]
+        instructions: Treat customer data as private. Policy text goes to Legal for review.
+  - id: operations
+    name: Operations
+    roles:
+      - id: operations-lead
+        name: COO
+        kind: head
+        mission: Keep stock and shipping predictable.
+        responsibilities:
+          - Write stock and fulfilment plans
+          - State assumptions behind each plan
+        skill_needs:
+          - plan inventory and stock
+          - write operations procedures
+        skill_categories: [operations, project-management]
+        outputs: [TaskReport]
+        instructions: You have no live stock data unless a person provides a file. Mark every assumption.

try_professional/_templates/general-company/template.yaml

@@ -0,0 +1,10 @@
+# The nine departments that ship as packs, so this has no departments of its own.
+id: general-company
+name: General company
+description: A general-purpose company with product, engineering, marketing, sales, research, finance, and operations.
+examples:
+  - a general business
+  - a company with several lines of work
+  - a professional services firm
+  - a small business that needs a bit of everything
+source: packs